このタグは、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 です。省略可能。

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

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

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

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

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

論理値です。true の場合は、生成された HTML <input> タグが表示される前に、ラベルを表示します。デフォルトは false です。省略可能。

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

labelkey 属性の適切な文字列を探し出すために使用されるロケール。指定した場合は、ブラウザが AcceptLang 文字列で指定するロケールに優先します。次の構文を使用します。"<languageCode>_<countryCode>"詳しくは、「ロケールコード」を参照してください。デフォルトでは、ブラウザの AcceptLang 文字列で指定される最初のロケールが使用されます。この属性を指定し、labelkey 属性を指定しない場合は、エラーがスローされます。省略可能。

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

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

HTML 属性

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

value

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

accesskey

class

disabled

id

label

onafterupdate

onbeforeupdate

onblur

onchange

onclick

ondblclick

ondragstart

onfocus

onhelp

onkeydown

onkeypress

onkeyup

onmousedown

onmousemove

onmouseout

onmouseover

onmouseup

onselect

onselectstart

readonly

style

tabindex

title

(value)

Domtags タグライブラリ

用語集