sharedhat

前回Mootoolsの Form.Validater.Inlineを使用するで簡単な説明をしましたが、今回は
バリデータの種類とForm.Validater.Inlineで指定できるオプションについて説明します。
種類と指定できるオプションは豊富で柔軟な入力チェックを行えるのがForm.Validater.Inlineの特徴です。


コメントフォームでは必須チェック、メールアドレスチェック、最大文字数チェックしか使用していませんでしたが、その他に下記のリストのようなチェックも可能です。

バリデータ一覧

  • required
    入力されているのかをチェックします。
    <input type="text" name="someField" value="" class="required" />
    
  • minLength
    文字の長さが最小値以上かチェックします。
    <input type="text" name="someField" value="" class="minLength:10" />
    
  • maxLength
    文字の長さが最大値以下かチェックします。
    <input type="text" name="someField" value="" class="maxLength:5" />
    
  • validate-numeric
    入力内容が数値であるかをチェックします。
    少数、マイナスの数値も入力できます。

    <input type="text" name="someField" value="" class="validate-numeric" />
    
  • validate-integer
    入力内容が整数であるかをチェックします。
    <input type="text" name="someField" value="" class="validate-integer" />
    
  • validate-digits
    入力内容が数値であるかをチェックします。
    又数値のほかに次の文字を含めることができます。
    電話番号なのどに使用するとよいでしょう。

    ().:-+#

    <input type="text" name="someField" value="" class="validate-digits" />
    
  • validate-alpha
    入力内容が半角英数であるかをチェックします。
    <input type="text" name="someField" value="" class="validate-alpha" />
    
  • validate-alphanum
    入力内容が半角英数字であるかをチェックします。
    <input type="text" name="someField" value="" class="validate-alphanum" />
    
  • validate-date
    入力内容が日付であるかをチェックします。
    又、dateFormatプロパティが使用でき、日付のフォーマットを指定することができます。
    日付フォーマットは以下のページで確認できます。
    日付フォーマット
    http://mootools.net/docs/more/Native/Date#Date:format

    <input type="text" name="someField" value="" class="validate-date dateFormat:'%Y/%m/%d'" />
    
  • validate-email
    入力内容がメールアドレスであるかチェックします。
    <input type="text" name="someField" value="" class="validate-email" />
    
  • validate-url
    入力内容がURLであるかチェックします。
    <input type="text" name="someField" value="" class="validate-url" />
    
  • validate-currency-dollar
    入力内容が通貨であるかチェックします。
    <input type="text" name="someField" value="" class="validate-currency-dollar" />
    
  • validate-one-required
    入力内容がひとつ以上入力されているかチェックします。
    <input type="checkbox" name="someField[]" value="1" />
    <input type="checkbox" name="someField[]" value="2" />
    <input type="checkbox" name="someField[]" value="3" class="validate-one-required" />
    

Form.Validater.Inlineのオプション

Form.Validater.Inlineのオプションでエラーメッセージに情報を追加したり、入力チェック完了後の動作をコントロールすることができます。
通常のWebサイ制作ではほとんど使わないであろうものもありますが、システム開発時には役に立つものもあります。

No. キー データ型 説明
1 stopOnFailure boolean

入力エラー発生時にフォーム内容の送信を中断する/しない。
デフォルトはtrueで中断します。

2 fieldSelectors string

入力チェックを適用させる要素セレクタ。 デフォルトは’input, select, textarea’。

3 useTitles boolean

エラーメッセージに入力フィールドの名称を含める/含めない。デフォルトはfalseで含めない。
別途input、select、textareaなどにtitle属性を指定する必要があります。

4 evaluateOnSubmit boolean

入力チェックをすべてパスした場合にフォームの内容を送信する/しない。
デフォルトはtrueでフォームの内容を送信します。

5 evaluateFieldsOnBlur boolean

入力フィールドから別の入力フィールドにフォーカスが移る際に入力チェックを行う/行わない。
デフォルトはtrueで入力チェックを行います。

6 evaluateFieldsOnChange boolean

入力内容が変更された際に入力チェックを行う/行わない。
デフォルトはtrueで入力チェックを行います。

7 serial boolean

なんて翻訳していいかわからなかった…。

8 ignoreHidden boolean

フォーム内の隠し要素(hidden)の入力チェックを行う/行わない。
デフォルトはtrueで入力チェックを行いません。

9 ignoreDisabled boolean

無効になっている入力フィールドの入力チェックを行う/行わない。
デフォルトはtrueで入力チェックを行いません。

10 warningPrefix string

指定した内容が警告メッセージの先頭に追加されて表示されます。

11 errorPrefix string

指定した内容がエラーメッセージの先頭に追加されて表示されます。

12 onFormValidate function

すべての入力チェックが完了した際に実行されます。
引数は下記の通りです。

  • isValid – (boolean) 入力チェック結果
  • form – (element) Form要素
  • event – (event) Eventオブジェクト
13 onElementValidate function

入力チェックが実行された際に発生します。
引数は下記の通りです。

  • isValid – (boolean) 入力チェック結果
  • element – (element) 入力チェック対象の要素
  • validater – (string) 入力チェック名。required、maxLengthなど
  • warning – (boolean) trueの場合は警告、falseの場合はエラー
14 onElementPass function

すべての入力チェックをパスした際に発生します。
引数は下記の通りです。

  • element – (element) 入力チェック対象の要素
15 onElementFail function

ひとつ以上の入力チェックに失敗した際に発生します。
引数は下記の通りです。

  • element – (element) 入力チェック対象の要素
  • validators – (array) 入力チェック名。required、maxLengthなど
16 scrollToErrorsOnSubmit boolean

入力エラーがあった入力フィールドまでスクロールする/しない。
デフォルトはtrueでスクロールします。

17 scrollFxOptions object

入力エラー時のスクロールオプション。
Fx.Scrollと同じ仕様。

バリデータ一覧と指定できるオプションは以上です。
次回は実践的な内容に入ります。

Trackback:

It is a comment that has been gotten before.

トラックバックを下記のURLに送ってください。
http://sharedhat.com/blog/860/trackback/

Reply:

Please give the comment to this article.





個人的なフォトログサイト

Wordpressのフォトログテーマ

Concrete5のアドオンパッケージ

this site is licensed under a Creative Commons License But, a part of contents is excluded.
Powered by WordPress