Struts ネスト・タグの属性

この参照資料では、Struts ネスト・タグ・ ライブラリーの属性について説明します。 デフォルトで、各要素名に接頭部 nested: が付きます。

Struts タグおよびタグ属性について 詳しくは、Apache Struts の 仕様を参照してください。

それぞれの Struts タグには、そのタグの 「プロパティー」ビューを使用して設定できる多くの属性があります。タグの「プロパティー」ビューでの作業中に、 さらに詳しい情報が必要な属性があった場合は、次の属性のテーブルを使用してください。 属性の中には、 名前が同じでも、異なる要素では使用法が異なるものがあります。属性は、 アルファベット順にリストされています。

チェック・ボックス

表 1. チェック・ボックス・タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーがフォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
errorStyleId エラーが存在する場合に、この HTML 要素に適用 される ID。 指定された場合、この属性はエラーが発生すると、styleId 属性を オーバーライドします。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property 指定した値に設定される、この実行依頼に入れられる要求パラメーターの 名前を指定します。
注: これは、必須の属性です。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value フォームの送信時に、このチェック・ボックスが選択済みの場合に 送信される値を指定します。デフォルトでは、このチェック・ボックスが選択されていると、 値 on が戻されます。

ページの先頭に戻る。

定義

表 2. 定義タグ属性
属性 説明
id 指定済みプロパティーの値で使用可能にするスクリプト記述変数の名前 (および関連する ページ scope 属性) を指定します。
注: これは、必須の属性です。
name 新規ページの scope 属性定義のためにアクセスされるプロパティーを含む Bean の 属性名 (property を指定する 場合)、またはこのタグによって作成された新規参照で重複している Bean の 属性名 (property を指定しない 場合) を指定します。この属性は、value 属性または ネストされた本体コンテンツを指定しない限り、必須です。
property name で指定した Bean でアクセスされる プロパティーの名前を指定します。この値は、単純、索引付き、またはネストされたプロパティー参照式にすることができます。デフォルト では、name で識別された Bean には、id で識別された新規参照が置かれます。
scope name で指定した Bean を取り出すために 検索する変数の有効範囲を指定します。デフォルト では、PageContext.findAttribute() によって適用されるデフォルト・ルール が適用されます。
toScope 新規に定義された Bean を作成する変数の有効範囲を指定します。 デフォルトでは、Bean は page の有効範囲に作成されます。
type id 属性として公開される値の 完全修飾クラス名を指定します。デフォルト は、value 属性を指定した場合は java.lang.String であり、 それ以外は java.lang.Object です。
value 公開される Bean に設定される java.lang.String 値 を指定します。この属性は、name 属性またはネストされた本体コンテンツを指定しない限り、必須です。

ページの先頭に戻る。

空き

表 3. 空きタグ属性
属性 説明
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。

ページの先頭に戻る。

等しい

表 4. 等しいタグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

ページの先頭に戻る。

エラー

表 5. エラー・タグ属性
属性 説明
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
footer メッセージの反復の終了後に印刷されるオプションのメッセージ・リソース・キーを指定します。
header メッセージの反復の開始前に印刷されるオプションのメッセージ・リソース・ キーを指定します。
locale 国際化メッセージの検索に使用する要求またはセッションの locale 属性 の値を指定します。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
prefix エラー・メッセージの前に印刷されるオプションのメッセージ・リソース・ キーを指定します。指定されていない場合は、errors.prefix にデフォルト設定 されます。
property エラー・メッセージを表示させるプロパティーの 名前を指定します。デフォルトでは、(プロパティーに関係なく) すべてのエラー・メッセージ が表示されます。
suffix エラー・メッセージの後に印刷されるオプションのメッセージ・リソース・ キーを指定します。指定されていない場合は、errors.suffix にデフォルト設定 されます。

ページの先頭に戻る。

ファイル

表 6. ファイル・タグ属性
属性 説明
accept ユーザーが実行依頼するサーバーが処理方法を認識できるように、 コンマで区切られたコンテンツ・タイプ・リストを指定します。このリストは、クライアント・ブラウザー が選択できるファイル・オプションのセットを制限する ために使用されます。デフォルトでは、コンテンツ・タイプ・リストは送信されません。
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
errorStyleId エラーが存在する場合に、この HTML 要素に適用 される ID。 指定された場合、この属性はエラーが発生すると、styleId 属性を オーバーライドします。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
maxlength 受け入れ可能な最大入力文字数を 指定します。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property 指定した値に設定される、この実行依頼に入れられる要求パラメーターの 名前を指定します。
注: これは、必須の属性です。
size 割り振る文字位置の数を指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。

ページの先頭に戻る。

フォーム

表 7. フォーム・タグ属性
属性 説明
acceptCharset サーバーが受け入れる必要がある入力データの文字エンコードのリスト。
action この転送の宛先の実コンテンツ相対 URI を含むグローバル・アクションの論理名を指定します。action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。 [form の場合は必須]
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
enctype メソッドが POST の場合に、このフォームの送信に使用されるコンテンツのエンコード方式 を指定します。ファイル・タグを使用してファイル・アップロードを使用できるようにする場合は、 これを multipart/form-data に設定する必要があります。この属性を 省略すると、ブラウザーのデフォルト (通常は application/x-www-form-urlencoded) が使用されます。
focus (このフォーム上にあるフィールドの中から) JavaScript 関数で初期フォーカスを割り当てるフィールド名を指定します。 この属性を省略すると、この目的での特殊な JavaScript コードのレンダリングは行われません。
focusIndex フォーカス・フィールドがラジオ・ボタン・グループなどのフィールド配列 の場合、フォーカスを受け取る配列内の索引を指定します。
lang この要素用の言語コード。
method この要求を実行依頼するために使用される HTTP メソッド (GET または POST) を指定します。
onreset フォームがリセットされると、JavaScript イベント・ハンドラーを実行します。
onsubmit このフォームが 実行されると、JavaScript イベント・ハンドラーを実行します。
readonly true に設定すると、この入力フィールドは読み取り専用になります。
scriptLanguage false に設定されている場合は、フォームのフォーカス <script> 要素には、 言語属性は含まれません。デフォルトは true ですが、 このプロパティーは XHMTL モードでは無視されます。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
target フレーム付きでの表示で使用する場合など、このフォームの送 信先のウィンドウ・ターゲットを指定します。

ページの先頭に戻る。

以上

表 8. 以上タグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

ページの先頭に戻る。

より大

表 9. より大タグ属性
プロパティー 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

ページの先頭に戻る。

非表示

表 10. 非表示タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property value を指定しない場合は、 入力フィールドの名前と対応する Bean プロパティーの名前を 指定します。対応する Bean プロパティー (ある場合) はタイプ String でなければなりません。
注: これは、必須の属性です。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value このフィールドが初期化される値を指定します。
write true に設定すると、HTML type="hidden" 要素を作成するだけでなく、このフィールドの値を応答ページにレンダリングして可視にします。 デフォルトでは、 隠し要素のみが作成されます。

ページの先頭に戻る。

イメージ

表 11. イメージ・タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
align このイメージの位置合わせを指定します。
非推奨: この属性は HTML 4 では使用すべきではありません。代わりに CSS の使用を推奨します。詳しくは、www.w3.org/TR/REC-html40/struct/objects.html#h-13.7.4 を参照してください。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
border イメージの周囲の枠の幅 (ピクセル単位) を 指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
locale 国際化メッセージの検索に使用する要求またはセッションの locale 属性 の値を指定します。
module page または pageKey 属性が 関連するモジュールの接頭部名。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
page このハイパーリンク (アクティブな場合) が制御権を移動する先のモジュール相対パス (スラッシュ (/) で始める) を指定します。 action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。
pageKey この入力タグに対して、イメージのモジュール相対パスを指定している メッセージ・リソース・ストリングのキーを指定します。
property このイメージ・タグのプロパティー名を指定します。要求の パラメーター名は、property.x および property.y と表示されます。 この x と y は、イメージのマウス・クリックの座標を 表します。このような値をフォーム Bean から取り出すには、getX()、getY()、setX()、および setY() メソッドを定義して、プロパティーを 空ストリング (property="") に指定します。
src この入力タグに対して、イメージのソース URL を指定 します。
srcKey この入力タグに対して、イメージのソース URL を指定している メッセージ・リソース・ストリングのキーを指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value このボタンに付けられるラベルの値を 指定します。この値は、指定した要求パラメーターの値としても送信 されます。

ページの先頭に戻る。

Img

表 12. Img タグ属性
属性 説明
action この転送の宛先の実コンテンツ相対 URI を含むグローバル・アクションの論理名を指定します。action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。 [form の場合は必須]
align 以下の値のいずれかを用いてイメージの位置合わせ方法を 指定します。
left
左揃え、テキストを右で折り返す
right
右揃え、テキストを左で折り返す
top
イメージを同じ行のテキスト上部と合わせる
middle
イメージの垂直方向の中央をテキストのベースラインと合わせる
bottom
イメージをテキストのベース・ライン下部と合わせる
texttop
イメージの上部を同じ行のテキスト・フォントの上部と合わせる
absmiddle
イメージの垂直方向の中央をテキストの絶対中央と合わせる
absbottom
イメージを同じ行のテキスト・フォントの絶対下部と合わ せる
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
border イメージの周囲の枠の幅 (ピクセル単位) を 指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
height 表示されるイメージの高さを指定します。この属性を width と一緒に指定すると、ブラウザーによるページのレンダリングが 高速になります。
hspace イメージとテキストの間の水平方向余白の量を 指定します。テキストをイメージと同じパラグラフに入れたり、イメージの周りで折り返したりすることもできます。
imageName ユーザーがこのページ内のスクリプトから参照できるように ページ内で定義される名前を指定します。ここで指定した値は、 生成された img 要素内の name 属性 の値になります。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
ismap このイメージが属するサーバー・サイド・マップの名前を 指定します。
lang この要素用の言語コード。
locale 国際化メッセージの検索に使用する要求またはセッションの locale 属性 の値を指定します。
module action 属性によって指定 されたアクションのアクション・マッピングを 含むモジュールの接頭部名。 これを有効にするには、action 属性を 指定する必要があります。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
page このハイパーリンク (アクティブな場合) が制御権を移動する先のモジュール相対パス (スラッシュ (/) で始める) を指定します。 action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。
pageKey この入力タグに対して、イメージのモジュール相対パスを指定している メッセージ・リソース・ストリングのキーを指定します。
paramId 生成済みハイパーリンクに動的に追加する要求パラメーターの名前を指定します。 対応する値は paramName および (オプション) paramProperty 属性 で定義され、オプションで paramScope 属性でスコープされます。
paramName paramId で指定した要求パラメーターの値を含む String である JSP Bean の名前 (paramProperty を省略する場合)、あるいは String を戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (paramProperty を指定する場合) を指定します。 JSP Bean は、paramScope プロパティーで指定されている Bean の有効範囲 に制限されます (指定されている場合)。
paramProperty paramName 属性で指定した Bean の プロパティー名を指定します。この場合の戻り値は、 このハイパーリンクに動的に追加される (paramId 属性で指定した) 要求パラメーター の値を含む String でなければなりません。
paramScope paramName 属性で指定した Bean を検索する有効範囲を指定します。 デフォルトでは 全有効範囲が検索対象となります。
property name 属性で指定した Bean のプロパティーの名前を指定します。 この場合の戻り値は、ハイパーリンクに追加される照会パラメーターを含む java.util.Map クラスでなければなりません。この属性を指定する場合は、name 属性も指定しなければなりません。
scope name 属性で指定した Bean を検索する 有効範囲を指定します。デフォルトでは 全有効範囲が検索対象となります。
src この入力タグに対して、イメージのソース URL を指定 します。
srcKey この入力タグに対して、イメージのソース URL を指定している メッセージ・リソース・ストリングのキーを指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
useLocalEncoding true に設定された場合、LocalCharacterEncoding が使用されます。つまり、URL のパラメーター上で URLEncoding が実行される際に、優先される文字エンコードとして、UTF-8 ではなく HttpServletResponse に設定された characterEncoding です。
usemap このイメージのホット・スポット・エリアのマッピングのために、このページ内に定義 されたマップ名を指定します。
vspace イメージとテキストの間の上下の垂直方向余白の量を 指定します。
width 表示するイメージの幅を指定します。この属性を height と一緒に指定すると、ブラウザーによるページのレンダリングが 高速になります。

ページの先頭に戻る。

反復

表 13. 反復タグ属性
属性 説明
collection 反復される (特定の要件に準拠する) コレクションに評価するランタイム式を指定します。
id 反復ごとに、コレクションの現行要素を含むページの有効範囲 JavaServer Pages (JSP) Bean の名前を指定します (NULL でない場合)。
注: これは、必須の属性です。
indexId 反復ごとに、コレクションの現行索引を含むページの有効範囲 JSP Bean の名前を指定します。
length このページ内で反復される (ベースとなるコレクション からの) エントリーの最大数を指定します。これは、要求する値を直接示す整数、 あるいは要求する値を定義しているタイプ java.lang.Integer の (任意の有効範囲の) JSP Bean の名前のいずれかです。デフォルトでは、実行される反復の回数は制限されていません。
name 反復されるコレクションを含む JSP Bean の 名前 (property を省略する場合) または 反復されるコレクションを戻すプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
offset ベースとなるコレクションからのエントリーが反復される 開始点のゼロ相対索引を指定します。これは、要求する値を直接示す整数、 あるいは要求する値を定義しているタイプ java.lang.Integer の (任意の有効範囲の) JSP Bean の名前のいずれかにできます。デフォルト値はゼロであり、これは、コレクションが 先頭から反復されることを意味します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
type id 属性に指定された JSP Bean を介して公開される要素の、 完全修飾 Java™ クラス名を指定します。 デフォルトでは、タイプ変換は実行されません。
注: コレクションの実要素は、このクラスと代入互換でなければなりません。そうでないと、 要求時間の ClassCastException エラーが発生します。

ページの先頭に戻る。

以下

表 14. 以下タグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

ページの先頭に戻る。

未満

表 15. 未満タグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

ページの先頭に戻る。

リンク

表 16. リンク・タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
action この転送の宛先の実コンテンツ相対 URI を含むグローバル・アクションの論理名を指定します。action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。 [form の場合は必須]
anchor 生成済みハイパーリンクに追加するオプションのアンカー・タグを指定します。 属性値に番号記号 (#) を指定しないでください。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
forward この転送の宛先の実コンテンツ相対 URI を含むグローバル ActionForward の論理名を指定します。action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。
href このハイパーリンクが、アクティブな場合に制御権を移動 する先の URL を指定します。action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、indexId 属性からの名前付き indexed パラメーターを照会ストリングに追加します。 indexed パラメーターは、index[int] のように なります。ここで、int は反復のたびに生成され、 祖先 logic:iterate タグから取得されます。
indexId indexed パラメーターに対して異なる名前を指定します。 詳しくは、indexed 属性を参照してください。
lang この要素用の言語コード。
linkName このページ内のハイパーリンクが参照できるように ページ内で定義されるアンカー名を指定します。ここで指定した値は、 生成済み anchor タグ内の name 属性 の値になります。
module action 属性によって指定されたアクションのアクション・マッピングを 含むモジュールの接頭部名。 これを有効にするには、action 属性を 指定する必要があります。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
page このハイパーリンク (アクティブな場合) が制御権を移動する先のモジュール相対パス (スラッシュ (/) で始める) を指定します。 action、forward、href、または page の属性のうちいずれかを指定しなければなりません。 paramId 属性または name 属性を追加すれば、このハイパーリンクを動的に変更することができます。
paramId 生成済みハイパーリンクに動的に追加する要求パラメーターの名前を指定します。 対応する値は paramName および (オプション) paramProperty 属性 で定義され、オプションで paramScope 属性でスコープされます。
paramName paramId で指定した要求パラメーターの値を含む String である JSP Bean の名前 (paramProperty を省略する場合)、あるいは String を戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (paramProperty を指定する場合) を指定します。 JSP Bean は、paramScope プロパティーで指定されている Bean の有効範囲 に制限されます (指定されている場合)。
paramProperty paramName 属性で指定した Bean の プロパティー名を指定します。この場合の戻り値は、 このハイパーリンクに動的に追加される (paramId 属性で指定した) 要求パラメーター の値を含む String でなければなりません。
paramScope paramName 属性で指定した Bean を検索する有効範囲を指定します。 デフォルトでは 全有効範囲が検索対象となります。
property name 属性で指定した Bean のプロパティーの名前を指定します。 この場合の戻り値は、ハイパーリンクに追加される照会パラメーターを含む java.util.Map クラスでなければなりません。この属性を指定する場合は、name 属性も指定しなければなりません。
scope name 属性で指定した Bean を検索する 有効範囲を指定します。デフォルトでは 全有効範囲が検索対象となります。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
target フレーム付きでの表示で使用する場合など、このフォームの送 信先のウィンドウ・ターゲットを指定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
transaction true に設定すると、生成済みハイパーリンクに現在のトランザクション制御トークンを組み込んで、受信アクション内で isTokenValid() テストを渡せるようにします。
useLocalEncoding true に設定された場合、LocalCharacterEncoding が使用されます。つまり、URL のパラメーター上で URLEncoding が実行される際に、優先される文字エンコードとして、UTF-8 ではなく HttpServletResponse に設定された characterEncoding です。

ページの先頭に戻る。

一致

表 17. 一致タグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
location 指定されない場合は、変数と値の間の突き合せが、変数文字列の 任意の位置で発生する可能性があります。 指定された場合は、変数文字列の指定された場所 (開始または終了) で突き合せが発生します。
name property を省略する場合は、突き合わせされる 変数がこの属性で指定した JSP Bean となるように指定し、property を指定する場合は、 この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

ページの先頭に戻る。

メッセージ

表 18. メッセージ・タグ属性
属性 説明
arg0 最初のパラメーターの置換値を指定します (ある場合)。
arg1 2 番目のパラメーターの置換値を指定します (ある場合)。
arg2 3 番目のパラメーターの置換値を指定します (ある場合)。
arg3 4 番目のパラメーターの置換値を指定します (ある場合)。
arg4 5 番目のパラメーターの置換値を指定します (ある場合)。
bundle メッセージを含む MessageResources オブジェクトが保管されて いるアプリケーションの有効範囲 Bean の名前を指定します。デフォルトは Globals.MESSAGES_KEY です。
key メッセージ・リソース内に必ず対応する値を持つ、 要求済みメッセージのメッセージ・キーを指定します。 デフォルトでは、キーは name プロパティーおよび property プロパティーから取得されます。
locale 現在選択済みのロケール・オブジェクトが保管されて いるセッション・スコープ Bean の名前を指定します。デフォルトは Globals.LOCALE_KEY です。
name property で指定した値 (指定している場合) を取り出すためにアクセスされるプロパティーを含む Bean の属性名を 指定します。property を省略すると、この Bean そのものの 値がメッセージ・リソース・キーとして使用されます。
property name で指定した Bean でアクセスされる プロパティーの名前を指定します。この値は、単純、索引付き、またはネストされたプロパティー参照式にすることができます。デフォルト では、name で識別された Bean には、id で識別された新規参照が置かれます。
property name で指定した Bean でアクセスされる プロパティーの名前を指定します。この値は、単純、索引付き、またはネストされたプロパティー参照式にすることができます。デフォルト では、name で識別された Bean の値がそのままメッセージ・リソース・キーとして使用されます。
scope name で指定した Bean を取り出すために 検索する変数の有効範囲を指定します。デフォルト では、PageContext.findAttribute() によって適用されるデフォルト・ルール が適用されます。

ページの先頭に戻る。

メッセージ

表 19. メッセージ・タグ属性
属性 説明
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
footer メッセージの反復の終了後に印刷されるオプションのメッセージ・リソース・キーを指定します。
header メッセージの反復の開始前に印刷されるオプションのメッセージ・リソース・ キーを指定します。
id 反復ごとに、メッセージのコレクションの現行要素を含むページの有効範囲 JSP Bean の必須名を指定します (NULL でない場合)。
注: これは、必須の属性です。
locale 国際化メッセージの検索に使用する要求またはセッションの locale 属性 の値を指定します。
message true に設定すると、Globals.MESSAGE_KEY 定数ストリングから Bean を取り出します。name 属性に割り当てられている値は無視されます。 デフォルトでは、 このタグは、Globals.ERROR_KEY 定数ストリングから反復される Bean を 取り出します。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
property メッセージを表示させるプロパティーの 名前を指定します。デフォルトでは、(プロパティーに関係なく) すべてのメッセージ が表示されます。

ページの先頭に戻る。

メッセージ非表示

表 20. メッセージ非表示タグ属性
属性 説明
message true に設定すると、Globals.MESSAGE_KEY 定数ストリングから要求有効範囲 Bean を取り出しますが、 name 属性に割り当てられた値を無視します。デフォルトでは、このタグは、Globals.ERROR_KEY 定数ストリングから、反復される要求有効範囲 Bean を取り出します。
name 要求有効範囲からメッセージを取り出すためのパラメーター・キー を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。

ページの先頭に戻る。

メッセージ表示

表 21. メッセージ表示タグ属性
属性 説明
message true に設定すると、Globals.MESSAGE_KEY 定数ストリングから要求有効範囲 Bean を取り出しますが、 name 属性に割り当てられた値を無視します。デフォルトでは、このタグは、Globals.ERROR_KEY 定数ストリングから、反復される要求有効範囲 Bean を取り出します。
name 要求有効範囲からメッセージを取り出すためのパラメーター・キー を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。

ページの先頭に戻る。

マルチ・ボックス

表 22. マルチ・ボックス・タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property 指定した値に設定される、この実行依頼に入れられる要求パラメーターの 名前を指定します。
注: これは、必須の属性です。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value フォームの送信時に、このチェック・ボックスが選択済みの場合に 送信される値を指定します。デフォルトでは、このチェック・ボックスが選択されていると、 値 on が戻されます。

ページの先頭に戻る。

ネスト

表 23. ネスト・タグ属性
属性 説明
property このタグおよびすべての子タグが相対するプロパティーを指定します。

空でない

表 24. 空でないタグ属性
属性 説明
name (任意の有効範囲に) JSP Bean が存在するかどうかを、 指定した名前で検査します。さらに property も指定した場合、name は、指定したプロパティーの NULL 以外のプロパティー値について検査します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。

等しくない

表 25. 等しくないタグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

不一致

表 26. 不一致タグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
location 指定されない場合は、変数と値の間の突き合せが、変数文字列の 任意の位置で発生する可能性があります。 指定された場合は、変数文字列の指定された場所 (開始または終了) で突き合せが発生します。
name property を省略する場合は、突き合わせされる 変数がこの属性で指定した JSP Bean となるように指定し、property を指定する場合は、 この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。
注: これは、必須の属性です。

非表示

表 27. 非表示タグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name property を省略する場合は 比較される変数として JSP Bean を指定し、property を指定する場合は この Bean の指定済みプロパティーの値を指定します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
value このタグの別の属性で指定した変数と比較する 定数値を指定します。

オプション

表 28. オプション・タグ属性
属性 説明
collection (なんらかの有効範囲の) JavaServer Pages (JSP) Bean の名前を指定します。 これは、その他の Bean からなるコレクションであり、各 Bean は、それぞれのオプションの値およびラベルを検索するために使用する property および labelProperty 属性 で名前が指定されるプロパティーを持ちます。
filter false に設定すると、HTML で区別される文字のオプション・ラベルのフィルターを抑制します。 デフォルトでは、このような値は、それぞれの同等なエンティティーに変換されます。
labelName これらのオプションに対して、ユーザーに表示されるラベルのコレクションを含む (ある有効範囲の) JSP Bean の名前を指定します。
labelProperty これらのオプションに対して、 ユーザーに表示されるラベルのコレクションを戻すフォーム Bean (すなわち、labelName 属性によって指定 された Bean) のプロパティーを指定します。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
property これらのオプションに対して、 サーバーに戻される値のコレクションを戻すフォーム Bean (すなわち、name 属性で指定 された Bean) のプロパティーを指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。

オプション収集

表 29. オプション収集タグ属性
属性 説明
filter false に設定すると、HTML で区別される文字のオプション・ラベルのフィルターを抑制します。 デフォルトでは、このような値は、それぞれの同等なエンティティーに変換されます。
label オプションごとにレンダリングされるラベルを表す コレクション内の Bean のプロパティーを指定します。デフォルトは label です。
name この入力フィールドの現行値のレンダリング時に相談 されるプロパティーを含む Bean の属性名を指定します。デフォルトでは、 その内部でこの要素がネストされているフォーム・タグと関連付けられている Bean が使用されます。
property これらのオプションに対して、 サーバーに戻される値のコレクションを戻すフォーム Bean (すなわち、name 属性で指定 された Bean) のプロパティーを指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
value 各オプションに対してレンダリングされる値を表す、 コレクション内の Bean のプロパティーを指定します。デフォルトは value です。

パスワード

表 30. パスワード・タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
errorStyleId エラーが存在する場合に、この HTML 要素に適用 される ID。 指定された場合、この属性はエラーが発生すると、styleId 属性を オーバーライドします。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
maxlength 受け入れ可能な最大入力文字数を 指定します。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property 指定した値に設定される、この実行依頼に入れられる要求パラメーターの 名前を指定します。
注: これは、必須の属性です。
readonly true に設定すると、この入力フィールドは読み取り専用になります。
redisplay false に設定すると、既存値が再表示されないことを示します。 可視の HTML ページ上では再表示される値が アスタリスクで表示されますが、実際のパスワード値の平文は、クライアント・ブラウザー の「ページ・ソースの表示 (Show Page Source)」メニュー・オプションから 見ることができます。デフォルトは true です。 ログイン・ページでこの値を false に設定することもできます。
size 割り振る文字位置の数を指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value このボタンに付けられるラベルの値を 指定します。この値は、指定した要求パラメーターの値としても送信 されます。

表示

表 31. 表示タグ属性
属性 説明
cookie value 属性の値と比較する値を含む cookie の名前を指定します。
header 比較する値を含むヘッダーの名前を 指定します。名前は、大/小文字を区別しないで突き合わせされます。
name (任意の有効範囲に) JSP Bean が存在するかどうかを、 指定した名前で検査します。さらに property も指定した場合、name は、指定したプロパティーの NULL 以外のプロパティー値について検査します。
parameter value 属性の値と比較する値を含む URL 要求パラメーターの名前を指定します。
property 比較する値を含む (name 属性で指定した Bean の) プロパティーの名前を 指定します。プロパティー参照は、単純、ネスト型、または 索引付きにできます。
role 現在の認証ユーザー (いる場合) が、指定済みセキュリティー・ロールのいずれかと 関連付けられているかどうかを検査します。複数の役割を指定するには、 役割名をコンマで区切ります。
scope name プロパティーで指定した Bean を検索する Bean 有効範囲を指定します。デフォルトでは、あらゆる有効範囲を 使用します。
user 現在の認証ユーザーが、指定した名前を持っているかどうかを 検査します。

ラジオ・ボタン

表 32. ラジオ・ボタン・タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
errorStyleId エラーが存在する場合に、この HTML 要素に適用 される ID。 指定された場合、この属性はエラーが発生すると、styleId 属性を オーバーライドします。
idName radio タグの値を戻す (ある有効範囲の) Bean の名前を 指定します。通常はイテレーターによって公開される idName 属性 がある場合、 この反復でラジオ・タグの値を戻す idName Bean 上 のプロパティーの名前として value 属性が使用されます。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property このラジオ・タグに対する対応する Bean プロパティー を指定します。
注: これは、必須の属性です。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value このボタンに付けられるラベルの値を 指定します。この値は、指定した要求パラメーターの値としても送信 されます。

ルート

表 33. ルート・タグ属性
属性 説明
name すべての子がネストされたタグが Bean 参照を派生する Bean の名前。

ページの先頭に戻る。

選択

表 34. 選択タグ属性
属性 説明
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
errorStyleId エラーが存在する場合に、この HTML 要素に適用 される ID。 指定された場合、この属性はエラーが発生すると、styleId 属性を オーバーライドします。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
multiple 受け入れ可能な最大入力文字数を 指定します。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property 指定した値に設定される、この実行依頼に入れられる要求パラメーターの 名前を指定します。
注: これは、必須の属性です。
rows 表示する行数を指定します。
scope name 属性で指定した Bean を検索する 有効範囲を指定します。デフォルトでは 全有効範囲が検索対象となります。
scrolling スクロール・バーを無条件に作成する (yes) か、まったく作成しない (no) か、 あるいは必要なときにのみ作成する (auto) かを指定します。
size 割り振る文字位置の数を指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
usemap このイメージのホット・スポット・エリアのマッピングのために、このページ内に定義 されたマップ名を指定します。
value 選択したオプションのマーキングのために比較する値を 指定します。

ページの先頭に戻る。

サイズ

表 35. サイズ・タグ属性
属性 説明
collection 配列、コレクション、またはマップに対して評価するランタイム式。
id タイプ java.lang.Integer の ページの有効範囲 JSP Bean の名前。カウントされる基礎となるコレクションのサイズを含むために作成されます。
注: これは、必須の属性です。
name カウントされるコレクションを含む (property が指定されない場合)、 またはプロパティー getter が呼び出されて、カウントされるコレクションを戻す (property が指定された場合)、JSP Bean の名前 (オプションとして、スコープ属性によって指定された有効範囲に制限されます)。
property name 属性で指定した Bean のプロパティーの名前。getter メソッドが、カウントされるコレクションを戻します。
scope name 属性で指定した JSP Bean を検索する Bean 有効範囲。指定されていない場合は、使用可能な有効範囲が昇順で検索されます。

ページの先頭に戻る。

実行

表 36. 実行タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
property 指定した値に設定される、この実行依頼に入れられる要求パラメーターの 名前を指定します。
注: これは、必須の属性です。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value このボタンに付けられるラベルの値を 指定します。この値は、指定した要求パラメーターの値としても送信 されます。

ページの先頭に戻る。

テキスト

表 37. テキスト・タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
errorStyleId エラーが存在する場合に、この HTML 要素に適用 される ID。 指定された場合、この属性はエラーが発生すると、styleId 属性を オーバーライドします。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
maxlength 受け入れ可能な最大入力文字数を 指定します。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
onselect ユーザーが 1 行テキスト領域でいくつかのテキストを 選択した場合、JavaScript イベント・ハンドラーを実行します。
property value を指定しない場合は、 入力フィールドの名前と対応する Bean プロパティーの名前を 指定します。対応する Bean プロパティー (ある場合) はタイプ String でなければなりません。
注: これは、必須の属性です。
readonly true に設定すると、この入力フィールドは読み取り専用になります。
size 割り振る文字位置の数を指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value このフィールドが初期化される値を指定します。

ページの先頭に戻る。

テキスト域

表 38. テキスト域タグ属性
属性 説明
accesskey この要素に直ちにフォーカスを移動するために使用する キーボード文字を指定します。
alt コンポーネントの代替テキストを指定します。この代替テキスト は、ブラウザーが、フォームをサポートしていない、イメージを表示しないように設定 されているなど、要素が正常にレンダリングされない場合に コンテンツとして機能します。
altKey この要素用の代替テキストのメッセージ・リソース・キー を指定します。
bundle 使用する MessageResources インスタンスの サーブレット・コンテキスト属性キーを指定します。このキーは、アクション・サーブレットに 構成されているアプリケーション・リソースにデフォルト設定します。
cols 表示するカラム数を指定します。
dir この要素用の弱い/中立のテキストの方向。
disabled true に設定すると、 入力フィールドが使用不可になります。
errorKey エラー・メッセージが保管される、任意の有効範囲の Bean の名前。 この属性が指定されていない場合は、Globals.ERROR_KEY 定数ストリングによって指定された 名前が使用されます。この属性は、errorStyle、errorStyleClass および errorStyleId 属性と 併用され、<html:errors/> タグの名前属性と同じ値に設定する必要があります。
errorStyle エラーが存在する場合に、この HTML 要素に適用 される CSS スタイル。 指定された場合、この属性はエラーが発生すると、style 属性を オーバーライドします。
errorStyleClass エラーが存在する場合に、この HTML 要素に適用 される CSS stylesheet のクラス。指定された場合、この属性はエラーが発生すると、styleClass 属性をオーバーライドします。
errorStyleId エラーが存在する場合に、この HTML 要素に適用 される ID。 指定された場合、この属性はエラーが発生すると、styleId 属性を オーバーライドします。
indexed logic:iterate タグ内部でのみ有効です。 true の場合、html タグの名前が propertyName[int] としてレンダリングされます。ここで、int は反復のたびに生成され、祖先 logic:iterate タグから取得されます。
lang この要素用の言語コード。
name 照会パラメーターを表すマップを含む JSP Bean の名前 (property を 指定しない場合)、あるいはマップを戻すために呼び出されるプロパティー getter を含む JSP Bean の名前 (property を指定する場合) を指定します。
onblur この要素が入力フォーカスを失うと、JavaScript イベント・ハンドラー を実行します。
onchange この要素が入力フォーカスを失い、 その値が変更されていると、JavaScript イベント・ハンドラーを実行します。
onclick この要素がマウスでクリックされると、JavaScript イベント・ハンドラーを実行します。
ondblclick この要素がマウスでダブルクリックされると、JavaScript イベント・ハンドラーを実行します。
onfocus この要素が入力フォーカスを受け取ると、JavaScript イベント・ハンドラーを実行します。
onkeydown この要素がフォーカスを持ち、キーが押されると、JavaScript イベント・ハンドラーを実行します。
onkeypress この要素がフォーカスを持ち、キーが押されて 放されると、JavaScript イベント・ハンドラーを実行します。
onkeyup この要素がフォーカスを持ち、キーが放さ れると、JavaScript イベント・ハンド ラーを実行します。
onmousedown この要素がマウス・ポインターの下にあり、 マウス・ボタンが押されると、JavaScript イベント・ハンドラーを実行します。
onmousemove この要素がマウス・ポインターの下にあり、 そのポインターが移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseout この要素がマウス・ポインターの下にあり、 そのポインターが要素の外側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseover この要素がマウス・ポインターの下になく、そのポインターが要素の内側に移動すると、JavaScript イベント・ハンドラーを実行します。
onmouseup この要素がマウス・ポインターの下にあり、 マウス・ボタンを離すと、JavaScript イベント・ハンドラーを実行します。
onselect ユーザーが 1 行テキスト領域でいくつかのテキストを 選択した場合、JavaScript イベント・ハンドラーを実行します。
property value を指定しない場合は、 入力フィールドの名前と対応する Bean プロパティーの名前を 指定します。対応する Bean プロパティー (ある場合) はタイプ String でなければなりません。
注: これは、必須の属性です。
redisplay false に設定すると、既存値が再表示されないことを示します。 可視の HTML ページ上では再表示される値が アスタリスクで表示されますが、実際のパスワード値の平文は、クライアント・ブラウザー の「ページ・ソースの表示 (Show Page Source)」メニュー・オプションから 見ることができます。デフォルトは true です。 ログイン・ページでこの値を false に設定することもできます。
rows 表示する行数を指定します。
style コンポーネントに対して CSS スタイル情報を指定します (例えば 、style="font-size : 8pt ; color : red")。
styleClass この HTML 要素に適用する CSS stylesheet のクラスを指定します。 これにより、class 属性が作成されます。
styleId この HTML 要素に割り当てる ID を指定します。これにより、id 属性が作成されます。
tabindex この要素のタブ順序 (正の整数の昇順) を 設定します。
title この要素用の通知タイトルを指定します。
titleKey この要素用の通知タイトルに対するメッセージ・リソース・キーを 指定します。
value このフィールドが初期化される値を指定します。

ページの先頭に戻る。

書き込み

表 39. 書き込みタグ属性
属性 説明
bundle メッセージを含む MessageResources オブジェクトが保管されてい るアプリケーションの有効範囲 Bean の名前を指定します。デフォルトは Globals.MESSAGES_KEY です。
filter false に設定すると、HTML で区別される文字のレンダリング済みプロパティー値のフィルターを抑制します。 デフォルトでは、このような値は、それぞれの同等なエンティティーに変換されます。
format Bean またはプロパティー値を String オブジェクト に変換するために使用する書式制御ストリングを指定します。デフォルト では、value データ・タイプの書式制御ストリングは、 メッセージ・リソース内でキーに従って検索されます。
formatKey アプリケーション・リソース内で書式制御ストリングを検索するために使用する キーを指定します。
ignore true に設定した場合、name プロパティーおよび scope プロパティーで指定した Bean が存在しないと、何も書き込まずに戻します。 false に設定した場合、Bean が存在しないと、ランタイム例外をスローします。
locale 現在選択済みのロケール・オブジェクトが保管されて いるセッション・スコープ Bean の名前を指定します。デフォルトは Globals.LOCALE_KEY です。
name property で指定した値 (指定している場合) を取り出すためにアクセスされるプロパティーを含む Bean の属性名を 指定します。property を指定しないと、この Bean そのものの値がレンダリングされます。
注: これは、必須の属性です。
property name で指定した Bean でアクセスされる プロパティーの名前を指定します。デフォルト では、name で識別された Bean がそのままレンダリングされます。指定したプロパティーが NULL を戻した場合、出力はレンダリングされません。
scope name で指定した Bean を取り出すために 検索する変数の有効範囲を指定します。デフォルト では、PageContext.findAttribute() によって適用されるデフォルト・ルール が適用されます。

ページの先頭に戻る。

ネスティング書き込み

表 40. ネスティング書き込みタグ属性
属性 説明
filter false に設定すると、HTML で区別される文字のレンダリング済みプロパティー値のフィルターを抑制します。 デフォルトでは、このような値は、それぞれの同等なエンティティーに変換されます。
id 指定済みプロパティーの値で使用可能にするスクリプト記述変数の名前 (および関連する ページ scope 属性) を指定します。[必須]
property name で指定した Bean でアクセスされる プロパティーの名前を指定します。 デフォルト では、name で識別された Bean がそのまま レンダリングされます。 指定したプロパティーが NULL を戻した場合、出力はレンダリングされません。

ページの先頭に戻る。

フィードバック