Lotus Domino Designer 8 ヘルプ

JSP カスタムタグのライブラリ

checkbox タグ
form タグのコンテキストで、文書のアイテムの値を、チェックボックスコントロールを使用して編集できるようにします。このタグは、読み込み専用の値を生成するための読み込みモード、または HTML <input> タグを生成するための編集モードのフォームと相互作用します。編集モードの場合は、このタグは、文書が保存されるときに、自動的に、現在の文書の対応するアイテムの値を更新します。

このタグは、HTML の input タグの「value」属性と相互作用しますが、これを上書きすることはありません。単一の値のフィールドの場合は、文書の現在のアイテムの値が value 属性と一致するときに、チェックボックスが選択されます。複数の値のフィールドの場合は、アイテムのいずれかの値が value 属性で指定される値と一致するときにチェックボックスが選択されます。複数の値のフィールドの場合は、name 属性と選択される各 checkbox タグの itemname 属性が一致するようにしてください。

フォームが送信されるときには、選択されるチェックボックスの値のみが受け取られます。単一の値のフィールドの場合は、文書が保存されるときにチェックボックスの値が存在する場合は、その値はアイテムの値としてアイテムに書き込まれます。チェックボックスの値が存在しない場合は、"" (空の文字列) または 0 (ゼロ) がアイテム値に書き込まれます (型による)。複数の値のフィールドの場合には、フォームの送信データに、特定の名前に対してすべての選択された値が含まれ、これらの値はすべてアイテムの値として書き込まれます。

ユーザーの入力を評価するために検証用のタグを使用することはできません。エラーがスローされることはありませんが、検証が行われることもありません。値が確実に選択されるようにするには、デフォルトの値を「value」属性で指定します。

コンテキスト次のタグで有効です。

form

構文<domino:checkbox
name="name of the control"
itemname="name of the item in the document"
datatype="text|number|date|datetime|readers|authors|names"
multivalue="true|false"
default="formula or simple value"
label="text to display on control"
labelkey="resource string"
labelbefore="true|false"
bundle="name of .properties file bundle"
locale="<languageCode>_<countryCode>"
debug="true|false"
onfailure="inline|exception"
time="true|false"
value="HTML attribute that represents the checked state of a checkbox"
The standard HTML tag attributes listed below>
属性bundle

国際化されたメッセージを見つけ出すために使用するメッセージバンドルの名前。デフォルトは messages です。省略可能。

datatype

新しい文書に追加されるアイテムの型と、サーバーで実行される自動的な検証および変換の型です。次のいずれかです。

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

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

default

論理値です。デフォルトでチェックボックスを選択するかを指定します。true の場合は、チェックボックスが選択され、HTML value 属性の値が、文書のアイテムに設定されます。デフォルトは false です。省略可能。

itemname

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

labelbefore

論理値です。true の場合は、生成された HTML

<input>

タグが表示される前に、ラベルを表示します。デフォルトは false です。省略可能。

labelkey

ロケール固有のリソース文字列で、label 属性の代わりにロードされ、使用されます。存在する場合は、label 属性に優先します。省略可能。

locale

labelkey 属性の適切な文字列を探し出すために使用されるロケール。指定した場合は、ブラウザが AcceptLang 文字列で指定するロケールに優先します。次の構文を使用します。"<languageCode>_<countryCode>"詳しくは、「

ロケールコード

」を参照してください。デフォルトでは、ブラウザの AcceptLang 文字列で指定される最初のロケールが使用されます。この属性を指定し、labelkey 属性を指定しない場合は、エラーがスローされます。省略可能。

multivalue

論理値です。true の場合は、フィールドは複数の値をサポートすることを示します。checkbox タグが複数の値のフィールドで適切に動作するようにするには、指定された各 checkbox タグに対して name および itemname 属性は一致する必要があります。文書が保存されるときに、クライアントでチェックボックスが選択されている場合は、value 属性がアイテムの複数の値に追加されます。選択されていない場合は、アイテムの複数の値からその値が削除されます。アイテムのいずれかの値がチェックボックスの

HTML Attributes

属性と一致する場合は、チェックボックスが自動的に選択されます。デフォルトは false です。省略可能。

name

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

debug、onfailure、および time の定義については、「共通の Lotus Domino JSP タグの属性」を参照してください。

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

チェックボックスの選択状態を示す値を指定する HTML 属性。関連するアイテムがこの値のときには、チェックボックスが選択されます。必須。

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