jQuery EasyUI フォームプラグイン -Validatebox 検証ボックス
jQuery EasyUI プラグイン
$.fn.validatebox.defaults を介してデフォルトの defaults を上書きします。
検証ボックス(validatebox)は、フォームの入力フィールドを検証するために設計されています。ユーザーが無効な値を入力すると、背景色を変更し、警告アイコンとヒントメッセージを表示します。検証ボックス(validatebox)はフォーム(form)プラグインと統合でき、無効なフィールドの送信を防ぎます。
依存関係
- tooltip
使用法
マークアップから検証ボックス(validatebox)を作成します。
<input id="vv" class="easyui-validatebox" data-options="required:true,validType:'email'">
JavaScript を使用して検証ボックス(validatebox)を作成します。
<input id="vv">
$('#vv').validatebox({
required: true,
validType: 'email'
});
パスワードと再入力したパスワードが同じかどうかを確認します。
// extend the 'equals' rule
$.extend($.fn.validatebox.defaults.rules, {
equals: {
validator: function(value,param){
return value == $(param[0]).val();
},
message: 'Field do not match.'
}
});
<input id="pwd" name="pwd" type="password" class="easyui-validatebox" data-options="required:true">
<input id="rpwd" name="rpwd" type="password" class="easyui-validatebox"
required="required" validType="equals['#pwd']">
検証ルール
検証ルールは、required および validType プロパティを使用して定義されます。以下はすでに実装されているルールです:
- email:email の正規表現ルールに一致します。
- url:URL の正規表現ルールに一致します。
- length[0,100]:x から y 文字まで許可します。
- remote['http://.../action.do','paramName']:ajax リクエストを送信して値を検証し、成功した場合は 'true' を返します。
検証ルールをカスタマイズするには、$.fn.validatebox.defaults.rules を上書きして、検証関数と無効な情報を定義します。たとえば、minLength 検証タイプを定義します:
$.extend($.fn.validatebox.defaults.rules, {
minLength: {
validator: function(value, param){
return value.length >= param[0];
},
message: 'Please enter at least {0} characters.'
}
});
これで、この minLength 検証タイプを使用して、少なくとも5文字の入力が必要な入力ボックスを定義できます:
<input class="easyui-validatebox" data-options="validType:'minLength[5]'">
プロパティ
| 名前 | 型 | 説明 | デフォルト値 |
|---|---|---|---|
| required | boolean | フィールドに入力が必要かどうかを定義します。 | false |
| validType | string,array | フィールドの検証タイプを定義します(例:email、url など)。可能な値: 1. 検証タイプの文字列。単一の検証ルールを適用します。 2. 検証タイプの配列。複数の検証ルールを適用します。単一のフィールドに対する複数の検証ルールは、バージョン 1.3.2 以降で使用できます。 コード例: <input class="easyui-validatebox" data-options="required:true,validType:'url'"> <input class="easyui-validatebox" data-options=" required:true, validType:['email','length[0,20]'] "> |
null |
| delay | number | 最後の入力値の検証を遅延させます。このプロパティはバージョン 1.3.2 以降で使用できます。 | 200 |
| missingMessage | string | テキストボックスが空の場合に表示されるヒントテキスト。 | このフィールドは必須です。 |
| invalidMessage | string | テキストボックスの内容が無効な場合に表示されるヒントテキスト。 | null |
| tipPosition | string | テキストボックスの内容が無効な場合のヒントメッセージの位置を定義します。可能な値:'left'、'right'。このプロパティはバージョン 1.3.2 以降で使用できます。 | right |
| deltaX | number | X 方向のヒントのオフセット。このプロパティはバージョン 1.3.3 以降で使用できます。 | 0 |
| novalidate | boolean | true に設定すると、検証が無効になります。このプロパティはバージョン 1.3.4 以降で使用できます。 | false |
メソッド
| 名前 | パラメータ | 説明 |
|---|---|---|
| destroy | none | このコンポーネントを削除して破棄します。 |
| validate | none | テキストボックスの内容が有効かどうかを判定するために検証を実行します。 |
| isValid | none | validate メソッドを呼び出し、検証結果(true または false)を返します。 |
| enableValidation | none | 検証を有効にします。このメソッドはバージョン 1.3.4 以降で使用できます。 |
| disableValidation | none | 検証を無効にします。このメソッドはバージョン 1.3.4 以降で使用できます。 |
jQuery EasyUI プラグイン その他の拡張機能