フォームオプション

validator ( v )

フィールドを検証する設定項目です。"validator#required" は "v#required" と省略することができます。

次の例では、"mailaddress" という名前のカスタムフィールドを追加し、正しいメールアドレスであることをチェックします。

例

<input name="mailaddress" type="text" value="" />
<input type="hidden" name="field[]" value="mailaddress" />
<input type="hidden" name="mailaddress:validator#email" />

required	フィールドに「入力が必須である」という属性を指定します。 例）<input type="hidden" name="filedname:v#required" />
minLength	フィールドに文字数の下限を指定します。
maxLength	フィールドに文字数の上限を指定します。 例）<input type="hidden" name="filedname:v#maxLength" value="20" />
min	フィールドが数値の時、数値の下限を指定します。
max	フィールドが数値の時、数値の上限を指定します。
regex	フィールドの内容が "正規表現にマッチ" するかどうかをチェックします。 例）<input type="hidden" name="tel:v#regex" value="\d\{2,4\}-\d\{2,4\}-\d\{4\}" />
digits	フィールドの内容が "数値" かどうかをチェックします。
email	フィールドの内容が "正しいメールアドレス" かどうかをチェックします。
url	フィールドの内容が "正しいURL" かどうかをチェックします。
equalTo	フィールドの内容が "指定された別のフィールド" と同じかどうかをチェックします。 パスワードの再確認フォームのサンプル <input name="password" type="text" value="" /> 　<input type="hidden" name="field[]" value="password" /> <input name="password2" type="text" value="" /> 　<input type="hidden" name="field[]" value="password2" /> 　<input type="hidden" name="password2:v#equalTo" value="password" />
dates	フィールドの内容が"日付系の校正オプションを適用可能な形式"かどうかチェックします。(beta3から実装) 適用可能な形式 (月と日が1桁の場合、2桁目の0は必須ではありません) 1985-08-26、1985/08/26、1985.08.26、s60.8/26、h21.5.11
times	時間系の校正オプションを適用可能な形式かチェック
all_maxChecked	チェックボックス等の選択数の上限を指定します。( ※ver1.3.0で追加 )
all_minChecked	チェックボックス等の選択数の下限を指定します。( ※ver1.3.0で追加 )
all_justChecked	チェックボックス等の選択数を指定します。( ※ver1.3.0で追加 )
duplication	過去に送信されたメールアドレスかどうかをチェックします。フォームIDのログから判定するため、フォームIDである必要があります。( ※ver1.3.0で追加 ) 例）<input type="hidden" name="email:v#duplication" />

converter ( c )

指定されたフィールドを任意の形式に変換します。これは、変換に指定できるオプションPHPのmb_convert_kana関数に依存します。mb_convert_kana関数の仕様にならい、複数のオプションを指定することもできます。詳細は、上記のリファレンスをご確認ください。

次の例ではaddressという名前のカスタムフィールドを追加し、送信時に入力内容の全角英数を半角英数に変換しています。

例

<input name="address" type="text" value="" />
<input type="hidden" name="field[]" value="address" />
<input type="hidden" name="address:c" value="a" />

a	英数字 全角 → 半角
A	英数字 半角 → 全角
k	全角カナ → 半角カナ
K	半角カナ → 全角カナ
h	全角かな → 半角カナ
H	半角カナ → 全角かな
c	全角カナ → 全角かな
C	全角かな → 全角カナ

---