Wijmo ユーザーガイド > 概念 > 検証関数ライブラリ |
Wijmo は、入力ウィジェット以外に、いくつかの文字列解析関数と検証関数を検証関数ライブラリとして用意しています。これにより、対応する入力ルーチンと出力ルーチンを利用できます。Wijmo は、4種類の検証関数(Text、Mask、Date、Number)を用意しています。各関数には、value パラメータに加えて、オプションパラメータがあります。詳細については、以下に示す各種類の関数を参照してください。
テキスト検証関数には2つの形式があります。一方は、2つのパラメータ(value と format)を受け取ります。もう一方は、3つのパラメータ(value、minLength、maxLength)を受け取ります。どちらの関数も、value を指定の型として解析できない場合は false を返します。
bool $.wijinputcore.validateText(string value, string format); bool $.wijinputcore.validateText(string value, Number minLength, Number maxLength);
ドロップダウンしてパラメータの詳細とコード例を表示
パラメータ名 | 型 | 説明 |
---|---|---|
value | string | 検証する値です。 |
format | string | 値の検証に使用する書式設定文字列。 書式設定でサポートされるキーワードの詳細については、「テキスト書式のキーワード」を参照してください。 |
minLength | Number | 有効な入力として受け取る最少文字数。 |
maxLength | Number | 有効な入力として受け取る最多文字数。 |
テキスト検証の例 |
コードのコピー |
---|---|
$.wijinputcore.validateText("123", "9"); //returns: true $.wijinputcore.validateText("あ山9", "Z"); //returns: true $.wijinputcore.validateText("9999999", 4, 7); //returns: true |
マスク検証は、2つのパラメータを受け取り、ブール値を返します。value を指定の format で解析できない場合、この関数は false を返します。
bool $.wijinputcore.validateMask(string value, string format);
ドロップダウンしてパラメータの詳細とコード例を表示
パラメータ名 | 型 | 説明 |
---|---|---|
value | string | 検証する値です。 |
format | string | 値の検証に使用する書式設定文字列。 書式設定でサポートされるキーワードの詳細については、「マスク書式でサポートされるキーワード」を参照してください。 |
マスク検証の例 |
コードのコピー |
---|---|
$.wijinputcore.validateMask("1234567", "999-9999"); //returns: false |
数値書式設定は4つのパラメータを受け取ります。value パラメータだけが必須です。value を指定のパラメータで解析できない場合、この関数は false を返します。
bool $.wijinputcore.validateNumber(string value, Number minValue, Number maxValue, string culture);
ドロップダウンしてパラメータの詳細とコード例を表示
パラメータ名 | 型 | 説明 |
---|---|---|
value | string | 検証する値です。 |
minValue | Number | 有効な値として受け取る最小値。 |
maxValue | Number | 有効な値として受け取る最大値。 |
culture | string | 値の検証に使用するカルチャ。(一部のカルチャは、小数点記号にカンマを使用します。) |
数値検証の例 |
コードのコピー |
---|---|
$.wijinputcore.validateNumber("123,45.6", 100, 100000); //returns: true |
日付検証は、5つのパラメータを受け取ります。value パラメータだけが必須です。value を指定のパラメータで解析できない場合、この関数は false を返します。
bool $.wijinputcore.validateDate(string value, Date minDate, Date maxDate, string format, string culture);
ドロップダウンしてパラメータの詳細とコード例を表示
パラメータ名 | 型 | 説明 |
---|---|---|
value | string | 書式設定する値です。 |
minDate | Date | 有効な値として受け取る最早日。 |
maxDate | Date | 有効な値として受け取る最遅日。 |
format | string | 値の検証に使用する書式設定文字列。 書式設定でサポートされるキーワードの詳細については、「日付書式でサポートされるキーワード」を参照してください。 |
culture | string | 日付の検証に使用するカルチャ。 |
日付検証の例 |
コードのコピー |
---|---|
$.wijinputcore.validateDate("12/3/2012", new Date(2013,0,1), new Date(2013,11,31)); //returns: false $.wijinputcore.validateDate("平成 25年12月16日", new Date(2013,0,1), new Date(2013,11,31), "ggg ee年MM月dd日"); //returns: false |