input タグの name 属性の値の長さが指定された範囲でなければならないあることを指定します。検証が失敗した場合は、タグのボディが表示され、message または msgkey 値が validatesummary タグに提供されます。

検証する input タグの clientvalidate 属性が「none」でないことを確認してください。input タグを含む form タグの clientvalidate 属性は「true」に設定してください。

コンテキスト

次のタグで有効です。

form

<domino:validatelength
name="input tag name"
max="maximum length"
min="minimum length"
message="message to display if validation fails"
msgkey="message bundle key"
bundle="name of .properties file bundle"
locale="<languageCode>_<countryCode>"
alert="true|false"
onalert="alert dialog box message"
debug="true|false"
onfailure="inline|exception"
time="true|false"
The HTML tag attributes listed below>

alert

true が指定され、クライアントサイドの検証が有効な場合 (form タグの clientvalidate 属性 = true) は、検証エラーが起こると、ポップアップ形式のアラートダイアログボックスが表示されます。ダイアログボックスの内容は、次の順番で行われる検索によって提供されます。

1) onalert 属性値

2) msgkey 属性値

3) message 属性値

4) このタグのボディ


デフォルトは false です。省略可能。

デフォルトの検索順番に従います。メッセージが見つからなかった場合は、デフォルトのリソースバンドル名は messages が使用されます。msgkey 属性の値を指定しない場合は、この属性の値も指定できません。省略可能。

適切なメッセージバンドル検索するために使用するロケール。指定した場合は、ブラウザが AcceptLang 文字列で指定するロケールに優先します。次の構文を使用します。"<languageCode>_<countryCode>"詳しくは、「ロケールコード」を参照してください。デフォルトでは、ブラウザの AcceptLang 文字列で指定される最初のロケールが使用されます。msgkey 属性の値を指定しない場合は、この属性の値も指定できません。省略可能。

指定した場合は、入力フィールドに入力される文字数は、この値以下でなければなりません。この属性か min 属性のいずれかを指定する必要があります。また、両方の値を指定することもできます。

検証が失敗した場合に、validatesummary タグが表示するメッセージ。この属性の内容は、パススルー HTML として扱われます。省略可能。

指定した場合は、入力フィールドに入力される文字数は、この値以上でなければなりません。この属性か max 属性のいずれかを指定する必要があります。また、両方の値を指定することもできます。

メッセージバンドルに関連付けられたキーの名前。省略可能。

検証を実行する input タグの名前。対応する input タグの name 属性と同じです。必須。

クライアントサイドの検証が失敗した場合に、アラートダイアログボックスに表示されるメッセージ。この属性に値を指定すると、alert 属性は自動的に true に設定されます。

HTML 属性

次の標準 HTML タグの属性については、「共通の HTML タグ属性」を参照してください。

class

style

Domtags タグライブラリ

用語集