機能説明

入力チェックを行うテキストフィールドを表示するタグです。

入力チェックの種類は以下のとおりです。
種類type属性説明
英数字チェックascii入力された値が半角英数字かどうかチェックします。
数値チェックnumber入力された値がminNum属性(最小値)、maxNum属性(最大値)の範囲内の数値文字列かどうかチェックします。
日付チェックdate入力された値がminDate属性(最小値)、maxDate属性(最大値)の範囲内の日付文字列かどうかチェックします。
入力チェックは、onblurイベント発生時に行われます。

サブミット時にもチェックを行いたい場合は、(このタグに対する)<FORM>タグのonsubmitイベントに "validate_check_XXX(YYY)" という関数をイベントハンドラとして登録してください。ここで、XXXは<Validate>タグの名前(name属性で指定した値)、YYYは生成された入力フィールドを表すオブジェクトになります。

注意事項:

<Vlidate>タグのデータを送信するフォームに対して<DblClickForbidden>タグが使用されている場合、入力チェックはonblurイベント発生時にのみ行われます。

属性一覧

注釈 属性名 説明 省略時の動作 実行時評価
必須
bgColor 入力フィールドの背景色。デフォルト値は "white" -
必須
canNull 入力フィールドが必須かどうかの設定。“true”または“false”のいずれかを指定します。
属性値が“false”の場合、入力フィールドに何も入力しないと警告ダイアログが表示されます。デフォルト値は "false"
-
必須
dateSeperator 日付文字列の年月日の区切り文字。デフォルト値は空文字。(この場合、はyyyyMMdd形式と解釈されます)
type属性が“date”の場合のみ設定できます。
-
必須
errorBgColor 入力エラー発生時の入力フィールドの背景色。デフォルト値は "red" -
必須
errorFgColor 入力エラー発生時の入力フィールドの文字色。デフォルト値は "white" -
必須
errorMsg 入力エラー発生時に表示するメッセージ。 -
必須
fgColor 入力フィールドの文字色。デフォルト値は "black" -
必須
frac 数値の小数部の最大桁数。デフォルト値は “0”。
type属性が“number”の場合のみ設定できます。
-
必須
inte 数値の整数部の最大桁数。デフォルト値は “9”。
type属性が“number”の場合のみ設定できます。
-
必須
maxDate 入力可能な最大日時。デフォルト値は “20991231”。
type属性が“date”の場合のみ設定できます。
-
必須
maxLength 入力フィールドの最大入力文字数。<INPUT>タグのmaxlength属性と同じです。 -
必須
maxNum 入力可能な最大値。デフォルト値は “999999999”。
type属性が“number”の場合のみ設定できます。
-
必須
minDate 入力可能な最小日時。デフォルト値は “19000101”。
type属性が“date”の場合のみ設定できます。
-
必須
minNum 入力可能な最小値。デフォルト値は “-999999999”。
type属性が“number”の場合のみ設定できます。
-
必須
name 入力フィールドの名前。<INPUT>タグのname属性と同じです。 -
必須
size 入力フィールドの大きさ。<INPUT>タグのsize属性と同じです。 -
必須
styleClass 入力フィールドに適用するスタイルのクラス名。。<INPUT>タグのclass属性と同じです。 -
必須
type 入力チェックの種類。“ascii”(英数字チェック)、“number”(数値チェック)、“date”(日付チェック)のいずれかを指定します。 -
必須
value 入力フィールドの初期値。 -

内部タグ

empty

サンプル

サンプル

サンプル
<pre>
<form onsubmit="return validate_check_code(this.code)">
  <table>
    <tr><th>コード</th>
      <td>
        <imtag:Validate name="code" type="ascii" 
            canNull="false" errorMsg ="コードには、半角英数字を入力して下さい。"/>
      </td>
    </tr>
    <tr><th>数値</th>
      <td>
        <imtag:Validate name="numeric" type="number" minNum="-10.5" maxNum="200"
            frac="1" canNull="true"
            errorMsg="数値には、-10.5から200までの値を入力して下さい。"/>
      </td>
    </tr>
    <tr><th>日付</th>
      <td>
        <imtag:Validate name="datetime" type="date" 
            minDate="19700101" maxDate="20101231" dateSeperator="/"
            canNull="true"
            errorMsg="日付には、1970/01/01から2010/12/31までの値を入力して下さい。"/>
      </td>
    </tr>
    <tr><td colspan="2" align="center">
      <input type="submit" value="送信">
    </td></tr>
  </table>
</form>
</pre>