jQuery EasyUI フォームプラグイン -Validatebox 検証ボックス


jQuery EasyUI 插件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 插件jQuery EasyUI プラグイン その他の拡張機能