前回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 |
入力エラー発生時にフォーム内容の送信を中断する/しない。 |
| 2 | fieldSelectors | string |
入力チェックを適用させる要素セレクタ。 デフォルトは’input, select, textarea’。 |
| 3 | useTitles | boolean |
エラーメッセージに入力フィールドの名称を含める/含めない。デフォルトはfalseで含めない。 |
| 4 | evaluateOnSubmit | boolean |
入力チェックをすべてパスした場合にフォームの内容を送信する/しない。 |
| 5 | evaluateFieldsOnBlur | boolean |
入力フィールドから別の入力フィールドにフォーカスが移る際に入力チェックを行う/行わない。 |
| 6 | evaluateFieldsOnChange | boolean |
入力内容が変更された際に入力チェックを行う/行わない。 |
| 7 | serial | boolean |
なんて翻訳していいかわからなかった…。 |
| 8 | ignoreHidden | boolean |
フォーム内の隠し要素(hidden)の入力チェックを行う/行わない。 |
| 9 | ignoreDisabled | boolean |
無効になっている入力フィールドの入力チェックを行う/行わない。 |
| 10 | warningPrefix | string |
指定した内容が警告メッセージの先頭に追加されて表示されます。 |
| 11 | errorPrefix | string |
指定した内容がエラーメッセージの先頭に追加されて表示されます。 |
| 12 | onFormValidate | function |
すべての入力チェックが完了した際に実行されます。
|
| 13 | onElementValidate | function |
入力チェックが実行された際に発生します。
|
| 14 | onElementPass | function |
すべての入力チェックをパスした際に発生します。
|
| 15 | onElementFail | function |
ひとつ以上の入力チェックに失敗した際に発生します。
|
| 16 | scrollToErrorsOnSubmit | boolean |
入力エラーがあった入力フィールドまでスクロールする/しない。 |
| 17 | scrollFxOptions | object |
入力エラー時のスクロールオプション。 |
バリデータ一覧と指定できるオプションは以上です。
次回は実践的な内容に入ります。
Related Post:
It is a list of related articles.
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.