Ignite UI™ API ヘルプ

ui.igValidator

コードサンプル

<!DOCTYPE html>
<html>
<head>
     <!--Ignite UI Required Combined CSS Files-->
    <link href="css/themes/infragistics/infragistics.theme.css" rel="stylesheet" />
    <link href="css/themes/infragistics/infragistics.ui.popover.css" rel="stylesheet" />
    <link href="css/themes/infragistics/infragistics.ui.notifier.css" rel="stylesheet" />
    <link href="css/themes/infragistics/infragistics.ui.editors.css" rel="stylesheet" />
    <link href="css/themes/infragistics/infragistics.ui.shared.css" rel="stylesheet" />
    <link href="css/structure/infragistics.css" rel="stylesheet" />
 
    <script src="js/modernizr-latest.js"></script>
    <script src="js/jquery.js"></script>
    <script src="js/jquery-ui.js"></script>
 
     <!--Ignite UI Required Combined JavaScript Files--> 
    <script src="js/infragistics.core.js"></script>
    <script src="js/infragistics.lob.js"></script>
 
    <script type="text/javascript">
 
        $(document).ready(function () {
 
            $('#validator').igTextEditor({
                placeHolder: "User name"
            });
 
              $('#validator').igValidator({
                notificationOptions: {
                    direction: "right",
                    showIcon: "true",
                    mode:"popover"
                },
                required:true
              });
        });
 
 
    </script>
</head>
<body>
    <input id="validator"/>
</body>
</html>

creditCard

タイプ:: enumeration
デフォルト:: false

クレジットカード番号検証ルールのオプションを取得または設定します。注: このルールは、カード型に関係なく Luhn アルゴリズムを使用して番号のチェックサムを検証します。

メンバー

boolean
タイプ:bool
フィールドが有効なクレジットカード番号かどうかを指定するブール値。
object
タイプ:object
構成オブジェクトおよびオプションのエラーメッセージ (例: creditCard: { errorMessage: "有効なカード番号を入力してください"} )。

コードサンプル

//Initialize
 $('.selector').igValidator({
    creditCard: true
});
//OR
$('.selector').igValidator({
    creditCard: {
        errorMessage : "Enter a valid card number"
    }
});
//Get
var creditCard = $('.selector').igValidator("option", "creditCard");
//Set
$('.selector').igValidator("option", 'creditCard', true);

custom

タイプ:: enumeration
デフォルト:: null

検証を実行するためのカスタム関数を取得または設定します。「this」を使用して、呼び出される検証コントロールを参照します。値およびオプションのフィールド設定引数を使用して、フィールドの状態を決定して返します。

メンバー

function
タイプ:function
呼び出す関数。
string
タイプ:string
グローバル名前空間の関数名 (window["name"])。
object
タイプ:object
method プロパティが関数である構成オブジェクト、およびオプションのエラーメッセージ。

コードサンプル

//Initialize
$('.selector').igValidator({
    custom: function(value, fieldOptions){
            return false;
        }
    });
//OR
$('.selector').igValidator({
    custom: {
        method: function(value, fieldOptions){
            return false;
        },
        errorMessage : "Value did not match"
    }
});
//Get
var custom = $(".selector").igValidator("option", "custom");
//Set
var custom = {
    method: function (value, fieldOptions) {
        return false;
    },
    errorMessage: "This field is required."
};
$(".selector").igValidator("option", "custom", custom);

date

タイプ:: enumeration
デフォルト:: false

日付検証ルールのオプションを取得または設定します。valueRange 検証に便利です。注: JavaScript Date の解析に依存関係があります。値の広い範囲を承諾します。

メンバー

boolean
タイプ:bool
フィールドが有効な JavaScript Date であるか、解析可能である必要かどうかを示すブール値。
object
タイプ:object
構成オブジェクトおよびオプションのエラーメッセージ (例: date: { errorMessage: "有効な数値を入力してください"} )。

コードサンプル

//Initialize
$('.selector').igValidator({
    date: true
});
//OR
$('.selector').igValidator({
    date: {
        errorMessage: "Not a valid date"
    }
});
//Get
var date = $(".selector").igValidator("option", "date");
//Set
$(".selector").igValidator("option", "date", true);

email

タイプ:: enumeration
デフォルト:: false

メール検証ルールのオプションを取得または設定します。"$.ui.igValidator.defaults" オブジェクトに定義される RegExp を使用します。

メンバー

boolean
タイプ:bool
フィールドがメールアドレスかどうかを指定するブール値。
object
タイプ:object
構成オブジェクトおよびオプションのエラーメッセージ (例: email: { errorMessage: "有効なメールアドレスを入力してください"} )。

コードサンプル

//Initialize
$('.selector').igValidator({
    email: true
}
//OR
$('.selector').igValidator({
    email: {
        errorMessage : "Enter a valid email"
    }
});
//Get
var email = $(".selector").igValidator("option", "email");
//Set
$(".selector").igValidator("option", "email", true);

equalTo

タイプ:: enumeration
デフォルト:: null

このフィールドの値が別の入力要素、またはエディターコントロールと同じである必要性を取得または設定します。

メンバー

string
タイプ:string
ターゲット要素の有効な jQuery セレクター。
object
タイプ:object
ターゲットの jQuery オブジェクトへの参照、または selector プロパティおよびカスタム errorMessage のオブジェクト。

コードサンプル

//Initialize
$('.selector').igValidator({
    equalTo: "#field1"
});
//OR
$('.selector').igValidator({
    equalTo: {
        selector: "#myEditor"
        errorMessage: "Value did not match."
    }
});
//Get
var equalTo = $(".selector").igValidator("option", "equalTo");
//Set
$(".selector").igValidator("option", "equalTo", "#field1");

errorMessage

タイプ:: string
デフォルト:: null

特定のルールで設定されていない場合、error-message のテキストを取得または設定します。デフォルトのルール固有のエラーメッセージをオーバーライドします。

コードサンプル

//Initialize
$('.selector').igValidator({
    errorMessage: 'This field is required!'
});
 
//Get
var errorMessage = $(".selector").igValidator("option", "errorMessage");
 
//Set
$(".selector").igValidator("option", "errorMessage", 'This field is required!');

executeAllRules

タイプ:: bool
デフォルト:: false

フィールドのすべてのルールをチェックすべきかどうかを取得または設定します。
注: 値なしで通常実行しないルールの空フィールドのチェックは強制しません。

コードサンプル

//Initialize
$('.selector').igValidator({
    executeAllRules: true
});
 
//Get
var executeAllRules = $(".selector").igValidator("option", "executeAllRules");
 
//Set
$(".selector").igValidator("option", "executeAllRules", true);

fields

タイプ:: array
デフォルト:: []
要素タイプ:: object

検証オプションおよび必須なセレクターをもつ項目を説明するターゲットフィールド項目のリストを取得します。フィールドが任意の検証ルールおよびトリガーを含みますが、その他のフィールドまたはイベントハンドラーを含みません。
適切なオプションが設定されない場合、グローバルコントロール構成から継承されます。

コードサンプル

//Initialize
$('.selector').igValidator({
    fields: [{
        selector: "#input1",
        required: true,
        number: true,
        onblur: false
    },
    {
        selector: "#input2",
        lengthRange: {
            min: 2,
            max: 10
        },
        onchange: true
    }]
});
 
//Get
var fields = $(".selector").igValidator("option", "fields");

selector

タイプ:

enumeration

デフォルト:

null
検証するためのターゲット要素 (入力またはコントロール対象要素) を取得します。このフィールド設定は必須です。
メンバー
- string
- タイプ:string
- 要素の有効な jQuery セレクター。
- object
- タイプ:object
- jQuery オブジェクトへの参照。
コードサンプル

//Initialize
$('.selector').igValidator({
    fields: [{
        selector: "#input1"
    },
    {
        selector: "#input2"
    }]
});

language
継承

タイプ:: string
デフォルト:: "en"

ウィジェットのロケール言語設定を取得または設定します。

コードサンプル

    //Initialize
$(".selector").igValidator({
    language: "ja"
});
 
// Get
var language = $(".selector").igValidator("option", "language");
 
// Set
$(".selector").igValidator("option", "language", "ja");

lengthRange

タイプ:: enumeration
デフォルト:: null

テキストの最小および最大長、または選択した項目の最小数および最大数を取得または設定します。null または 0 値は無視されます。

メンバー

array
タイプ:array
2 つの数字の配列。最初の値が最小値、最後の値が最大値です。(例: lengthRange: [ 1, 10] )。
object
タイプ:object
オプションのエラーメッセージをもつ構成オブジェクト。メッセージ文字列は最小値と最大値の形式を含めます (engthRange: { min: 6, max: 20, errorMessage: 「パスワードは {0} 以上 {1} 以下でなければなりません」} など)。

コードサンプル

//Initialize
$('.selector').igValidator({
    lengthRange: [2, 6]
});
//OR
$('.selector').igValidator({
lengthRange: {
    min: 2,
    max: 6,
    errorMessage: "Must be at least {0} long and no more than {1}."
}
});
//Get
var lengthRange = $(".selector").igValidator("option", "lengthRange");
//Set
$(".selector").igValidator("option", "lengthRange", [2, 6]);

locale
継承

タイプ:

object

デフォルト:

null

ウィジェットのロケール設定を取得または設定します。

コードサンプル

//Initialize
$(".selector").igValidator({
locale: {}
});

// Get
var locale = $(".selector").igValidator("option", "locale");

// Set
$(".selector").igValidator("option", "locale", {});

messageTarget

タイプ:: domelement
デフォルト:: null

検証メッセージに使用されるカスタム jQuery 要素を取得または設定します。ターゲットの innerHTML 属性が変更されます。ターゲットは SPAN、LABEL、または DIV が可能です。

コードサンプル

//Initialize
$('.selector').igValidator({
    messageTarget: "#field1"
});
 
//Get
var messageTarget = $(".selector").igValidator("option", "messageTarget");
 
//Set
$(".selector").igValidator("option", "messageTarget", "#field1");

notificationOptions

タイプ:: object
デフォルト:: null

エラーメッセージを表示するための igNotifier のオプションを取得または設定します。

コードサンプル

//Initialize
    $('.selector').igValidator({
    notificationOptions: {
        direction: "right",
        showIcon: "true",
        mode:"popover",
        messages: {
            error: "This field is required!"
        }
    }
    });
 
    //Get
    var notificationOptions = $(".selector").igValidator("option", "notificationOptions");
 
    //Set
    var notificationOptions = {
        direction: "right",
        showIcon: "true",
        mode:"popover",
        messages: {
            error: "This field is required!"
        };
 
    $(".selector").igValidator("option", "notificationOptions", notificationOptions);

number

タイプ:: enumeration
デフォルト:: false

数値検証ルールのオプションを取得または設定します。10 進および 1000 進のデフォルトのセパレーター文字は「.」および「,」で、"$.ui.igValidator.defaults" オブジェクトに定義されます。

メンバー

boolean
タイプ:bool
フィールドが数値かどうかを指定するブール値。デフォルトのセパレーター文字が使用されます。
object
タイプ:object
errorMessage、decimalSeparator、および thousandsSeparator を持つ構成オブジェクト。そのプロパティはすべてオプションです。

コードサンプル

//Initialize
$('.selector').igValidator({
    number: true
});
//OR
$('.selector').igValidator({
    number: {
        errorMessage : "Not a valid number",
        decimalSeparator: ".",
        thousandsSeparator: " "
    }
});
//Get
var number = $(".selector").igValidator("option", "number");
//Set
$(".selector").igValidator("option", "number", true);

onblur

タイプ:

bool

デフォルト:

true

エディターがフォーカスを失ったときに検証がトリガーされるかどうかを取得または設定します。

コードサンプル

//Initialize
$('.selector').igValidator({
onblur: true
});

//Get
var onblur = $(".selector").igValidator("option", "onblur");

//Set
$(".selector").igValidator("option", "onblur", true);
onchange

タイプ:

bool

デフォルト:

false

エディターのテキストが変更されたときに検証がトリガーされるかどうかを取得または設定します。注: チェックボックス、コンボ、レーティングなどの選択コントロールに適用します。テキストフィールドでメッセージが多くなる可能性があるため、最初の検証が threshold オプションによって遅延できます。

コードサンプル

//Initialize
$('.selector').igValidator({
onchange: true
});

//Get
var onchange = $(".selector").igValidator("option", "onchange");

//Set
$(".selector").igValidator("option", "onchange", true);
onsubmit

タイプ:

bool

デフォルト:

true

検証ターゲットを含むフォームが送信中の場合に検証がトリガーされるかどうかを取得または設定します。検証が失敗した場合、送信できません。ネイティブな JavaScript submit 関数に適用しませんが、jQuery の submit 関数およびブラウザーのデフォルト操作を処理します。

コードサンプル

//Initialize
$('.selector').igValidator({
onsubmit: true
});

//Get
var onsubmit = $(".selector").igValidator("option", "onsubmit");

//Set
$(".selector").igValidator("option", "onsubmit", true);

optionalIndication

タイプ:: bool
デフォルト:: false

オプションのフィールドの隣にラベル通知を表示するためのオプションを取得または設定します。
注: チェックボックスやオプションボタンのようなグループ化されたコントロールおよび igRating コントロールの場合はインジケーターがサポートされません。

コードサンプル

//Initialize
$('.selector').igValidator({
    optionalIndication: true
});
 
//Get
var optionalIndication = $(".selector").igValidator("option", "optionalIndication");
 
//Set
$(".selector").igValidator("option", "optionalIndication", true);

pattern

タイプ:: enumeration
デフォルト:: null

正規表現検証ルールのオプションを取得または設定します。

メンバー

string
タイプ:string
正規表現を含む文字列。
object
タイプ:object
RegExp オブジェクトまたは expression および errorMessage プロパティを持つオブジェクト。

コードサンプル

//Initialize
$(".selector").igValidator({
    pattern: "^\\d*\\.{0,1}\\d+$"
});
//OR
$('.selector').igValidator({
    pattern: {
        expression: /^[a-z]+$/,
        errorMessage : "Value did not match"
    }
});
//Get
var pattern = $(".selector").igValidator("option", "pattern");
//Set
$(".selector").igValidator("option", "pattern", "^\\d*\\.{0,1}\\d+$");

regional
継承

タイプ:

enumeration

デフォルト:

defaults

ウィジェットの領域設定を取得または設定します。

コードサンプル

//Initialize
$(".selector").igValidator({
regional: "ja"
});
// Get
var regional = $(".selector").igValidator("option", "regional");
// Set
$(".selector").igValidator("option", "regional", "ja");

required

タイプ:: enumeration
デフォルト:: false

値 (空でないテキスト、選択項目など) が入力されたかどうかを検証するオプションを取得または設定します。

メンバー

boolean
タイプ:bool
フィールドが必須であるかどうかを示すブール値。
object
タイプ:object
オプションのエラーメッセージをもつ構成オブジェクト (必須: { errorMessage: 「エラー」} など))。

コードサンプル

//Initialize
$('.selector').igValidator({
    required: true
});
//OR
$('.selector').igValidator({
    required: {
        errorMessage: "This field is required."
    }
});
//Get
var required = $(".selector").igValidator("option", "required");
//Set
$(".selector").igValidator("option", "required", true);

requiredIndication

タイプ:: bool
デフォルト:: false

必須のフィールドの隣にアスタリスク表示を表示するためのオプションを取得または設定します。
注: チェックボックスやオプションボタンのようなグループ化されたコントロールおよび igRating コントロールの場合はインジケーターがサポートされません。

コードサンプル

//Initialize
$('.selector').igValidator({
    requiredIndication: true
});
 
//Get
var requiredIndication = $(".selector").igValidator("option", "requiredIndication");
 
//Set
$(".selector").igValidator("option", "requiredIndication", true);

successMessage

タイプ:: string
デフォルト:: null

成功メッセージのテキストを取得または設定します。デフォルト値がないため、このメッセージを設定すると、成功通知の表示を有効にします。

コードサンプル

//Initialize
$('.selector').igValidator({
    successMessage: "Well done!"
});
 
//Get
var successMessage = $(".selector").igValidator("option", "successMessage");
 
//Set
$(".selector").igValidator("option", "successMessage", "Well done!");

threshold

タイプ:

number

デフォルト:

-1

最小の長さの入力の検証を取得または設定します。変更やぼかしでこの値にならない限り、入力の検証はトリガーされません。
注: フォームを送信するとき、必須のフィールドに影響しません。

コードサンプル

//Initialize
$('.selector').igValidator({
threshold: 1
});

//Get
var threshold = $(".selector").igValidator("option", "threshold");

//Set
$(".selector").igValidator("option", "threshold", 1);

valueRange

タイプ:: enumeration
デフォルト:: null

最小値および最大値を取得または設定します。null 値は無視されます。

メンバー

array
タイプ:array
2 つの数値または日付の配列。最初の値が最小値、最後の値が最大値です。(例: valueRange: [ 1, 10] )。
object
タイプ:object
オプションのエラーメッセージをもつ構成オブジェクト。メッセージ文字列は最小値と最大値の形式を含めます (lengthRange: { min: 6, max: 20, errorMessage: 「値は {0} ～ {1} でなければなりません」} など)。

コードサンプル

//Initialize
    $('.selector').igValidator({
        valueRange: [2, 6]
//OR
$('.selector').igValidator({
    valueRange: {
        min: 2,
        max: 6,
        errorMessage: "Value must be between {0} and {1}."
    }
});
//Get
var valueRange = $(".selector").igValidator("option", "valueRange");
//Set
var range = [2, 6];
$(".selector").igValidator("option", "valueRange", range);

Ignite UI コントロールイベントの詳細については、
Ignite UI でイベントを使用するを参照してください。

注: API メソッドの呼び出しは、API ヘルプに特に記述がない限り、操作に関連するイベントはプログラムによって発生されません。これらのイベントは各ユーザー操作によってのみ呼び出されます。

詳細の表示

error

キャンセル可能:: false

無効なフィールドの場合、値の検証後、なんらかの操作が有効になる前に発生するイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorerror", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //get current value in target
    ui.value;
    //get rules that failed validation
    ui.rules;
    //gets text of message
    ui.message;
    //get the options of the specific field in the collection
    ui.fieldOptions;
    });
 
//Initialize
$(".selector").igValidator({
    error: function (evt, ui) {
    ...
    }
});

errorHidden

キャンセル可能:: false

エラーメッセージが非表示になった後に発生するイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

    //Bind after initialization
    $(document).on("igvalidatorerrorhidden", ".selector", function (evt, ui) {
        //get reference to the igValidator widget
        ui.owner;
        //gets text of message
        ui.message;
        //get reference to the target of the message
        ui.target;
        //get the options of the specific field in the collection
        ui.fieldOptions;
});
 
//Initialize
$(".selector").igValidator({
    errorHidden: function (evt, ui) {
    ...
    }
});

errorHiding

キャンセル可能:: true

エラーメッセージが非表示になる前に発生するイベント。
エラーメッセージを表示し続けるには、False を返します。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorerrorhiding", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //gets text of message
    ui.message;
    //get reference to the target of the message
    ui.target;
    //get the options of the specific field in the collection
    ui.fieldOptions;
 
});
 
//Initialize
$(".selector").igValidator({
    errorHiding: function (evt, ui) {.
    ...
    }
});

errorShowing

キャンセル可能:: true

エラーメッセージが表示される前に発生するイベント。
エラーメッセージが表示されないようにするには、False を返します。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorerrorshowing", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //gets text of message
    ui.message;
    //get reference to the target of the message
    ui.target;
    //get the options of the specific field in the collection
    ui.fieldOptions;
});
 
//Initialize
$(".selector").igValidator({
    errorShowing: function (evt, ui) {
        ...
    }
});

errorShown

キャンセル可能:: false

エラーメッセージが表示された後に発生するイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

    //Bind after initialization
    $(document).on("igvalidatorerrorshown", ".selector", function (evt, ui) {
        //get reference to the igValidator widget
        ui.owner;
        //gets text of message
        ui.message;
        //get reference to the target of the message
        ui.target;
        //get the options of the specific field in the collection
        ui.fieldOptions;
});
 
    //Initialize
    $(".selector").igValidator({
        errorShown: function (evt, ui) {
        ...
        }
    });

formError

キャンセル可能:: false

フォームの送信イベントで検証を失敗した後で Validator インスタンスレベルにトリガーされるイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorformerror", ".selector", function (evt, ui) {
        //get reference to the igValidator widget
        ui.owner;
        //get reference of the event target form
        ui.target
    });
 
//Initialize
$(".selector").igValidator({
    formError: function (evt, ui) {
    ...
    }
});

formSuccess

キャンセル可能:: false

フォームの送信イベントで検証を成功にした後で Validator インスタンスレベルにトリガーされるイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorformsuccess", ".selector", function (evt, ui) {
        //get reference to the igValidator widget
        ui.owner;
        //get reference of the event target form
        ui.target;
    });
 
    //Initialize
    $(".selector").igValidator({
        formSuccess: function (evt, ui) {
        ...
        }
    });

formValidated

キャンセル可能:: false

フォームの送信イベントで検証後で Validator インスタンスレベルにトリガーされるイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorformvalidated", ".selector", function (evt, ui) {
        //get reference to the igValidator widget
        ui.owner;
        //get reference of the event target form
        ui.target;
        //determine the outcome of the validation
        ui.valid;
    });
 
//Initialize
$(".selector").igValidator({
formValidated: function (evt, ui) {
    ...
    }
});

formValidating

キャンセル可能:: true

フォームの送信イベントを処理する前に Validator インスタンスレベルにトリガーされるイベント。
検証をスキップし、その他の検証コントロールがエラーを返さない場合、送信を許可することを可能になるために false を返します。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorformvalidating", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //get reference of the event target form
    ui.target;
});
 
//Initialize
$(".selector").igValidator({
    formValidating: function (evt, ui) {
    ...
    }
});

success

キャンセル可能:: false

有効なフィールドの場合、値の検証後、なんらかの操作が有効になる前に発生するイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorsuccess", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //get current value in target
    ui.value;
    //gets text of message, if any
    ui.message;
    //get the options of the specific field in the collection
    ui.fieldOptions;
});
 
//Initialize
$(".selector").igValidator({
    success: function (evt, ui) {
    ...
    }
});

successHidden

キャンセル可能:: false

成功メッセージが非表示になった後に発生するイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorsuccesshidden", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //gets text of message
    ui.message;
    //get reference to the target of the message
    ui.target;
    //get the options of the specific field in the collection
    ui.fieldOptions;
    });
 
    //Initialize
    $(".selector").igValidator({
        successHidden: function (evt, ui) {
        ...
        }
    });

successHiding

キャンセル可能:: true

成功メッセージが非表示になる前に発生するイベント。
成功メッセージを表示し続けるには、False を返します。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorsuccesshiding", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //gets text of message
    ui.message;
    //get reference to the target of the message
    ui.target;
    //get the options of the specific field in the collection
    ui.fieldOptions;
    });
 
    //Initialize
    $(".selector").igValidator({
        successHiding: function (evt, ui) {
        ...
        }
    });

successShowing

キャンセル可能:: true

成功メッセージが表示される前に発生するイベント。
成功メッセージが表示されないようにするには、False を返します。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorsuccessshowing", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //gets text of message
    ui.message;
    //get reference to the target of the message
    ui.target;
    //get the options of the specific field in the collection
    ui.fieldOptions;
});
 
//Initialize
$(".selector").igValidator({
    successShowing: function (evt, ui) {
    ...
    }
});

successShown

キャンセル可能:: false

成功メッセージが表示された後に発生するイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorsuccessshown", ".selector", function (evt, ui) {
        //get reference to the igValidator widget
        ui.owner;
        //gets text of message
        ui.message;
        //get reference to the target of the message
        ui.target;
        //get the options of the specific field in the collection
        ui.fieldOptions;
    });
 
    //Initialize
    $(".selector").igValidator({
        successShown: function (evt, ui) {
        ...
        }
    });

validated

キャンセル可能:: false

値の検証後、なんらかの操作が有効になる前に発生するイベント。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorvalidated", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //get current value in target
    ui.value;
    //determine the outcome of the validation
    ui.valid;
});
 
//Initialize
$(".selector").igValidator({
    validated: function (evt, ui) {
    ...
    }
});

validating

キャンセル可能:: true

検証時、デフォルトの検証ロジックが適用される前に発生するイベント。
イベントをキャンセルし、フィールドを有効として実行するために false を返します。
関数は引数 evt および ui を受け取ります。

evt
タイプ: Event

jQuery イベントオブジェクト。
ui
タイプ: Object

コードサンプル

//Bind after initialization
$(document).on("igvalidatorvalidating", ".selector", function (evt, ui) {
    //get reference to the igValidator widget
    ui.owner;
    //get current value in target
    ui.value ;
    //get the options of the specific field in the collection
    ui.fieldOptions;
});
 
//Initialize
$(".selector").igValidator({
    validating: function (evt, ui) {
    ...
    }
});

詳細の表示

addField

.igValidator( "addField", field:object );
フィールドコレクションに新しい入力を追加し、検証コントロールで初期化します。注: 検証コントロールがコレクションで作成された場合にのみ追加のフィールドが適用されます。
- field
- タイプ:object
- フィールドセレクターおよびオプションをもつオブジェクト。
コードサンプル

var field = {
    selector: "#input1",
    required: true,
    number: true,
    onblur: false
};
$(".selector").igValidator("addField",field);
changeGlobalLanguage
継承

.igValidator( "changeGlobalLanguage" );
ウィジェットの言語をグローバルの言語に変更します。グローバルの言語は $.ig.util.language の値です。
コードサンプル

$(".selector").igValidator("changeGlobalLanguage");
changeGlobalRegional
継承

.igValidator( "changeGlobalRegional" );
ウィジェットの地域設定をグローバルの地域設定に変更します。グローバルの地域設定は $.ig.util.regional にあります。
コードサンプル

$(".selector").igValidator("changeGlobalRegional");
changeLocale
継承

.igValidator( "changeLocale", $container:object );
指定したコンテナーに含まれるすべてのロケールを options.language で指定した言語に変更します。
注: このメソッドは珍しいシナリオのみで使用されます。language または locale オプションのセッターを参照してください。
- $container
- タイプ:object
- オプションのパラメーター: 設定しない場合、ウィジェットの要素を $container として使用します。
コードサンプル

$(".selector").igValidator("changeLocale");
destroy

.igValidator( "destroy" );
検証コントロールウィジェットを破棄します。
コードサンプル

$(".selector").igValidator("destroy");
getErrorMessages

.igValidator( "getErrorMessages", [field:object] );

返却型:

array

返却型の説明:

すべての現在のエラーメッセージの配列。
無効なフィールドのすべての現在のエラーメッセージを取得します。このメソッドが検証を実行せずに、状態およびメッセージが検証のみで更新されるため、
formValidated イベントまたは validate/isValid メソッド呼び出しの後にこれを使用できます。
- field
- タイプ:object
- オプション
- エラーメッセージを取得する単一のフィールドのオプションのフィールドオブジェクト、セレクター、または 0 から始まるインデックス。
コードサンプル

var getErrorMessages = $(".selector").igValidator("getErrorMessages","#field1");
hide

.igValidator( "hide", [field:object] );
messageTarget または igNotifier の可能なメッセージを非表示にします。
注: validator がフィールドコレクションを持つ場合、フィールドを渡さない場合、すべてのフィールドでメッセージを非表示にします。
- field
- タイプ:object
- オプション
- メッセージを非表示するオプションのフィールドオブジェクト、セレクター、または 0 から始まるインデックス。
コードサンプル

$(".selector").igValidator("hide");
isMessageDisplayed

.igValidator( "isMessageDisplayed", [field:object] );

返却型:

bool

返却型の説明:

現在表示されているメッセージがある場合は True。
表示されているメッセージがあるかどうかを確認します。オプションフィールドを使用します。
注: validator がフィールドコレクションを持つ場合、フィールドを渡さない場合、単一のフィールドのみに表示されるメッセージがあっても true を返します。
- field
- タイプ:object
- オプション
- エラーメッセージを取得する単一のフィールドのオプションのフィールドオブジェクト、セレクター、または 0 から始まるインデックス。
コードサンプル

var isMessageDisplayed = $(".selector").igValidator("isMessageDisplayed","#field1");
isValid

.igValidator( "isValid", [field:object] );

返却型:

bool

返却型の説明:

フイールドがすべての検証を通過した場合は True。
検証をトリガーしますがエラーメッセージを表示しません。
- field
- タイプ:object
- オプション
- 確認するオプションのフィールドオブジェクト、セレクター、または 0 から始まるインデックス。フィールドコレクションの場合にのみ有効で他のフィールドはスキップします。
コードサンプル

var isValid = $(".selector").igValidator("isValid");
notifier

.igValidator( "notifier", [field:object] );

返却型:

object

返却型の説明:

igNotifier への参照、または無効なフィールドの場合は null。
igValidator または単一のフィールドの notifier を取得します。
- field
- タイプ:object
- オプション
- notifier を取得するオプションのフィールドオブジェクト、セレクター、または 0 から始まるインデックス。
コードサンプル

var notifier = $(".selector").igValidator("notifier");
removeField

.igValidator( "removeField", field:object );
フィールドコレクションから入力を削除します。
- field
- タイプ:object
- 削除されるフィールドオブジェクト、そのゼロから始まるインデックス、またはセレクター。
コードサンプル

$(".selector").igValidator("removeField","#input1");
updateField

.igValidator( "updateField", field:object, [fieldOptions:object] );
検証コントロールコレクションのフィールドを更新します。コントロールが validator の後に作成された場合にフィールドを再初期化するか、新しいオプションを渡すために使用されます。
- field
- タイプ:object
- 更新されるフィールドオブジェクト、そのゼロから始まるインデックス、またはセレクター。
- fieldOptions
- タイプ:object
- オプション
- フィールドに適用される新しいオプション。
コードサンプル

var newOptions = {
    required: true,
    number: true,
    onblur: false
};

$(".selector").igValidator("updateField","#input1", newOptions);
validate

.igValidator( "validate", [field:object] );

返却型:

bool

返却型の説明:

フイールドがすべての検証を通過した場合は True。
検証をトリガーし、無効なフィールドでエラーを表示します。
- field
- タイプ:object
- オプション
- 検証されるオプションのフィールドオブジェクト。フィールドコレクションの場合にのみ有効で他のフィールドはスキップします。
コードサンプル

var validate = $(".selector").igValidator("validate");

ui-igvalidator-optional-indication

オプションフィールドの隣の表示スパンに適用されるクラス。
ui-igvalidator-required-indication

オプションフィールドの隣のアスタリスク表示スパンに適用されるクラス。
ui-igvalidator-target

検証をもつターゲット要素に適用されるクラス。視覚効果がありません。

Ignite UI for jQuery | API リファレンス

ui.igValidator

コード サンプル

関連サンプル

関連トピック

依存関係

継承

コードサンプル