検証コントロール

本製品では、入力値を検証し、検証結果をグラフィカルなUIで通知する検証コントロールを提供します。

(図)検証コントロールの例

適用可能なコントロール

検証コントロールを使った検証機能は以下のコントロールに適用できます。

• テキストコントロール(GcTextBox)

• マスクコントロール(GcMask)

• コンボコントロール(GcComboBox)

• 数値コントロール(GcNumber)

• 日付時刻コントロール(GcDateTime)

• 複数行テキストコントロール(GcMultiLineTextBox)

• リッチテキストエディタコントロール(GcRichTextEditor)

検証方法と通知方法

検証コントロールでは、以下の検証方法と通知方法を提供します。

【検証規則】

• 必須入力

• 範囲外の入力(数値コントロール、日付時刻コントロールのみ有効)

• 入力文字数

• 他のコントロールと照合

• 外部検証結果の指定

• 独自の検証ロジック

【検証タイミング】

• フォーカス移動時(コントロールからフォーカスを失ったとき)

• 入力中(リアルタイム)

• 手動による検証(ボタン押下などの任意のタイミング)

【通知方法】

• ツールチップ通知(コントロールの周辺にツールチップを表示します。)

• アイコン通知(コントロールの内側または外側にアイコンを表示します。)

• コントロール状態による通知(コントロールの枠やテキストの色により通知します。)

基本的な使用方法

検証コントロールのインスタンスを初期化する際に、コンストラクタのオプションで検証方法を設定します。以下の例では、フォーカスを失ったタイミングで、必須入力の検証を実行するようにテキストコントロールに設定します。

var gcTextBox1 = new GC.InputMan.GcTextBox(document.getElementById("gcTextBox1"));

var validator1 = new GC.InputMan.GcValidator({
    items: [
        {
            control: gcTextBox1,
            ruleSet: [
                {
                    // 必須入力
                    rule: GC.InputMan.ValidateType.Required
                }
            ],
            // フォーカスを失ったときに検証する
            validateWhen: GC.InputMan.ValidateWhen.LostFocus
        }
    ],
    defaultNotify: {
        // ツールチップを表示する                                  
        tip: true
    }
});

検証コントロールの使用方法の詳細はオンラインデモをご参照ください。