ユーザーの入力に対してクライアントサイドの評価を実行するには、このタグの clientvalidate 属性を「onsubmit」または「onblur」に、form タグの clientvalidate 属性を「true」に設定します。さらに、次の検証タグのいずれかを含め、実行する検証の種類を指定する必要があります。

validatecc、validatedate、 validatelength、validatepattern、validaterange、validaterequired、validatesummary、validatewith。これらのタグは、値を設定する必要のあるフィールドを要求するか、入力された値が特定の形式、長さ、パターン、または範囲に適合するかをテストすることによってユーザーの入力を検証します。検証タグの name 属性は、評価対象となる Web コントロールの入力が識別できるように、このタグの name 属性と等しくする必要があります。

メモ 前述の検証タグを指定しない場合は、検証は実行されません。

コンテキスト

次のタグで有効です。

form

<domino:input
name="control name"
format="format for displaying"
editformat="format for editing"
timezone="time zone"
locale="<languageCode>_<countryCode>"
itemname="Domino item name"
datatype="text|number|date|datetime|readers|authors|names"
clientvalidate="onblur|onsubmit|none"
defaultformula="formula determining default value"
defaultvalue="simple value to use as default value"
multivalue="true|false"
mveditseparator="blank|comma|colon|semicolon"
mvdisplayseparator="blank|comma|semicolon"
value=""
debug="true|false"
onfailure="inline|exception"
time="true|false"
The standard HTML tag attributes listed below>

clientvalidate

ユーザーの入力を検証するタイミングを指定します。次のいずれかの文字を指定します。onsubmit、onblur、none。デフォルトは onsubmit です。この属性は、フォームがサーバーに送信される前にクライアントサイドの検証を実行します。この属性を onsubmit または onblur に指定する場合は、実行する検証を指定する検証タグを含める必要があります。省略可能。

新しい文書に追加されるアイテムの型と、サーバーで自動的に実行される検証の種類を指定します。次のいずれかの文字を指定します。

値	説明
text	検証を実行せず、入力された値を変換しません。
number	検証を実行し、入力された値を数値に変換します。
date	検証を実行し、入力された値を日付に変換します。
datetime	検証を実行し、入力された値を [datetime] フィールドに変換します。変換された値は、「10/02/99 10:10 PM」などの形式になります。
readers	検証を実行せず、入力された値を変換しません。アイテムを [readers] フィールドとして扱います。
authors	検証を実行せず、入力された値を変換しません。アイテムを [authors] フィールドとして扱います。
names	検証を実行せず、入力された値を変換しません。アイテムを [names] フィールドとして扱います。

デフォルトは text です。指定されたデータ型でデータを保存しようとしますが、文書の指定が優先する場合もあります。省略可能。

Lotus Notes の式を使用してアイテムのデフォルト値を指定します。このタグを含む form タグの schema 属性を指定する場合は、参照されるフォームのアイテムのデフォルト値は、この式で指定される値に優先します。省略可能。

単純な値として指定されるアイテムのデフォルト値。指定する文字列は、datatype、locale、mveditseparator、および multivalue 属性の値に基づいて変換されます。ブラウザのクライアントのロケールは変更される場合があるため、ISO 形式のデフォルトの日時の値を指定してください。このタグを含む form タグの schema 属性を指定する場合は、参照されるフォームのアイテムのデフォルト値は、この属性で指定される値に優先します。省略可能。

フォームが編集モードのときに、テキストを表示する形式。フォームが表示または読み込みモードのときには、日時および数値を表示する形式。editformat が指定されない場合は、format 属性の仕様が使用されます。

フォームが表示モードまたは読み込みモードのときに、キーワードによって指定されるテキストの表示形式。使用可能なフォーマットのキーワードは、「JSP のコンテンツをフォーマットする」を参照してください。format が指定されない場合は、日時は DATE TIME 形式を、数値は NUMBER 形式を使用します。テキストは Java toString() メソッドを使用して文字列に変換され、HTML 用に、自動的にエスケープされます。

この入力フィールドが関連付けられた文書のアイテムの名前。この属性は、たとえば、itemname ではその文字が無効なため、itemname とページのコントロールの name を変える必要があるときに便利です。デフォルトでは、この属性は name 属性の値と同じです。省略可能。

数値と日付の値を表示し、解釈方法を定義する入力コントロールをフォーマットするために使用されるロケール。指定した場合は、ブラウザが AcceptLang 文字列で指定するロケールに優先します。次の構文を使用します。"<languageCode>_<countryCode>"詳しくは、「ロケールコード」を参照してください。デフォルトでは、ブラウザの AcceptLang 文字列で指定される最初のロケールが使用されます。省略可能。

論理値です。true の場合は、入力フィールドは複数の値をサポートします。mveditseparator 属性は、複数の値を持つフィールドに対して、データ入力時に値を区切るために使用する文字を定義し、mvdisplayseparator 属性は、フィールドが表示されるときに複数の値を区切るために使用する文字を定義します。デフォルトは false です。省略可能。

読み込みまたは編集モードで、複数の値を持つフィールドに値を表示する際に、値を区切るために使用する文字を指定します。次のいずれかの文字を指定します。空白、カンマ、コロン、セミコロン。デフォルトは、セミコロンです。省略可能。

複数の値を持つフィールドで、データ入力時に、値を区切るために使用する値を指定します。次のいずれかの文字を指定します。空白、カンマ、セミコロン。複数の区切り文字を指定するには、区切り文字をカンマで区切ります。デフォルトは、カンマとセミコロンです。mvdisplayseparator 属性で指定される値がここで指定されない場合は、その値は自動的に追加されます。省略可能。

Web ページのコントロールの名前。文書のコントロールの itemname は、この値がデフォルトになります。必須。

日付を表示するために使用されるタイムゾーン。値を指定しない場合は、デフォルトはサーバーのタイムゾーンです (ブラウザのタイムゾーンではありません)。省略可能。

入力コントロールのラベル。文書のアイテムの値によって無効になることが多く、checkbox および radio タグによってチェックボックスまたはラジオボタンコントロールを表す値に使用される標準 HTML value 属性。省略可能。

HTML 属性

Lotus Domino は、次の HTML タグの属性をサポートしています。

type

type HTML 属性用の次のオプションは、Lotus Domino input タグでは使用できません。代わりに表に示すカスタムタグを使用してください。

オプション	代替タグ
checkbox	checkbox
ファイル	attachments
image	(代替はありません) 標準 HTML <input> タグを使用してください。
radio	radio

省略可能。

accesskey

class

dir

disabled

id

lang

language

maxlength

onafterupdate

onbeforeupdate

onblur

onchange

onclick

ondblclick

ondragstart

onfocus

onhelp

onkeydown

onkeypress

onkeyup

onmousedown

onmousemove

onmouseout

onmouseover

onmouseup

onselect

onselectstart

readonly

size

src

style

tabindex

title

(type)

入力コントロールに入力されたデータを検証する際に、エラーメッセージとしてローカライズしたファイルを使用する場合は、その入力コントロール用のエントリをプロパティファイルに追加する必要があります。エントリの形式の例を、次に示します。

name

ここで name は、メッセージが参照する input タグの name 属性と等しい値です。プロパティファイルに追加されるメッセージは、検証タグとともに message または msgkey 属性が指定されない場合のデフォルトのメッセージとして保存されます。

詳しくは、「ローカライズされたメッセージファイルを作成する」および「エラーを処理する方法」を参照してください。

メモ checkbox タグと radio タグは検証できません。JSP が、radio または checkbox コントロール用に値が選択されていることが必要な場合は、タグのデフォルトの値を指定してください。

関連項目

Domtags タグライブラリ

用語集