検証タイミング

検証対象となるコントロールに入力された値をどのタイミングで検証するかは、validateWhenプロパティを使用して設定します。このプロパティに設定可能な値は、以下の３つです。既定値はLostFocusです。

validateWhenの値	説明
LostFocus	コントロールがフォーカスを失ったときに検証します。（既定値）
Manual	validateメソッドを実行したときに検証します。
Typing	入力中にリアルタイムで検証します。

次のサンプルコードは、テキストボックス「gcTextBox1」に対する必須入力チェックを、validateメソッドを実行した時に行う例です。

var validator1 = new GC.InputMan.GcValidator({
 items: [
    {
      // 検証対象コントロール
      control: gcTextBox1,
      ruleSet: [
        {
          // 検証規則を「必須入力」とする
          rule: GC.InputMan.ValidateType.Required
        }
      ],
      // validateメソッドを実行した時に検証する
      validateWhen: GC.InputMan.ValidateWhen.Manual,
      notify:
      {
        // 検証結果をツールチップで表示する
        tip:true
      }
    }
  ]
});
validator1.validate();

以下のように、onclickイベントからvalidateメソッドを呼び出すことで、ボタンクリック時に検証することができます。

<button onclick="GcValidator1.validate()">検証</button>