Strutsページ構成タグ・ライブラリ

これは、Strutsページ構成タグ・ライブラリの開発者ガイドです。この項には、Apache Software Foundation(http://www.apache.org/)およびそれ以外のサード・パーティによって作成されたドキュメントが含まれます。

このタグ・ライブラリには、Struts入力フォームの作成に使用されるタグ、および一般にHTMLベースのユーザー・インタフェースの作成に役立つその他のタグが含まれます。

このタグ・ライブラリ内のタグの多くは、誤って使用すると(無効な組合せのタグ属性を指定した場合など)、実行時にJspExceptionをスローします。JSPでは、<%@ page %>ディレクティブでエラー・ページを宣言できます。問題を引き起こした実際の例外を処理する場合、それはキーorg.apache.struts.action.EXCEPTIONのリクエスト属性としてエラー・ページに渡されます。

タグ名 説明
base HTMLの<base>要素をレンダリングします。
button ボタン入力フィールドをレンダリングします。
cancel 取消ボタンをレンダリングします。
checkbox チェック・ボックス入力フィールドをレンダリングします。
errors 蓄積されたエラー・メッセージのセットを条件付きで表示します。
file ファイル選択入力フィールドをレンダリングします。
form 入力フォームを定義します。
frame HTMLフレーム要素をレンダリングします。
hidden 非表示フィールドをレンダリングします。
html HTMLの<html>要素をレンダリングします。
image imageタイプのinputタグをレンダリングします。
img HTMLのimgタグをレンダリングします。
javascript ValidatorPlugInによってロードされた検証規則に基づくJavaScript検証をレンダリングします。
link HTMLのアンカーまたはハイパーリンクをレンダリングします。
messages 蓄積されたメッセージのセットを条件付きで表示します。
multibox チェック・ボックス入力フィールドをレンダリングします。
option 選択オプションをレンダリングします。
options 選択オプションのコレクションをレンダリングします。
optionsCollection 選択オプションのコレクションをレンダリングします。
password パスワード入力フィールドをレンダリングします。
radio ラジオ・ボタン入力フィールドをレンダリングします。
reset リセット・ボタン入力フィールドをレンダリングします。
rewrite URIをレンダリングします。
select 選択要素をレンダリングします。
submit 送信ボタンをレンダリングします。
text テキスト・タイプの入力フィールドをレンダリングします。
textarea TextAreaをレンダリングします。

Struts HTMLタグ・ライブラリ<html:base>タグ

囲んでいるJSPページの絶対位置をhref属性によって指定するHTMLの<base>要素をレンダリングします。このタグは、HTMLの<head>要素にネストされている場合のみ有効です。このタグに関連付けられている属性はありません。

このタグは、最新の送信が行われたURLではなく、ページ自身のURLに基づいてページのURL相対参照が使用できるため、大変有用です(通常、ブラウザは、最新の送信が行われたURLについて相対参照を解決します)。

属性名 説明
target

このbase参照のためのウィンドウ・ターゲット。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:button>タグ

このタグ・ボディの指定の値またはコンテンツから、ボタン・タイプのHTMLの<input>要素をレンダリングします。このタグは、formタグ・ボディにネストされている場合のみ有効です。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がpropertyName[34]のようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。(REQUIRED)(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このボタンに表示されるラベルの値。またこの値は、指定のリクエスト・パラメータの値として送信されます。[このタグ・ボディ(存在する場合)またはClick](RT EXPR)

Struts HTMLタグ・ライブラリ<html:cancel>タグ

送信タイプのHTMLの<input>要素をレンダリングします。このタグは、formタグ・ボディにネストされている場合のみ有効です。この送信ボタンを押すと、アクション・サーブレットは、関連するフォームBeanのvalidate()メソッドのコールを行いません。アクションは正常にコールされます。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。警告: この属性をデフォルト以外の値に設定すると、Strutsコントローラ・サーブレットまたはAction.isCancelled()メソッドで取消キーとして認識されなくなります。独自の取消の検出を実行する必要があります。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このボタンに表示されるラベルの値。またこの値は、指定のリクエスト・パラメータの値として送信されます。[このタグ・ボディ(存在する場合)またはCancel](RT EXPR)

Struts HTMLタグ・ライブラリ<html:checkbox>タグ

現在のフォームに関連付けられているBeanの指定の値またはプロパティから、checkboxタイプのHTMLの<input>要素をレンダリングします。このタグは、formタグ・ボディにネストされている場合のみ有効です。

注意: このフィールドに関連付けられる、基礎となるプロパティ値は、boolean型です。指定するvalueは、true値を示すいずれかの文字列("true"、"yes"、または"on")に対応する必要があります。関連する文字列値セットを利用する場合は、multiboxタグの使用を考慮してください。

警告: チェックされていないチェック・ボックスを正しく認識するには、このフォームに関連付けられているActionForm Beanが、対応するブール型プロパティをreset()メソッドでfalseに設定する文を、インクルードする必要があります。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。(REQUIRED)(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このチェック・ボックスがチェックされているとき、フォームの送信時に送られる値。指定しない場合、値onが返されます。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:errors>タグ

ビジネス・ロジック・コンポーネントで用意され、ActionErrorsオブジェクト、文字列または文字列配列としてリクエスト・スコープに格納されている一連のエラー・メッセージを表示します。このようなBeanが検出されない場合は、何もレンダリングされません。

このタグを適切に使用するには、アプリケーション・スコープMessageResources Beanをデフォルトの属性名で定義しておく必要があります。オプションとして次のメッセージ・キーを定義することもできます。

属性名 説明
bundle

MessageResourcesインスタンスで使用されるサーブレット・コンテキスト属性キー。指定しない場合、アクション・サーブレットに対して設定されているアプリケーション・リソースがデフォルトとなります。(RT EXPR)

locale

表示されるメッセージの選択に使用するロケールのセッション属性キー。指定しない場合、Struts標準値がデフォルトとなります。(RT EXPR)

name

エラー・メッセージが格納されているリクエスト・スコープBeanの名前。存在しない場合は、Action.ERROR_KEY定数文字列で指定された名前が使用されます。(RT EXPR)

property

エラー・メッセージの表示対象のプロパティの名前。指定しない場合、すべてのエラー・メッセージが(プロパティに関係なく)表示されます。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:file>タグ

ファイル・タイプのHTMLの<input>要素をレンダリングします。デフォルトは、指定の値、または現在のフォームに関連付けられているBeanの指定のプロパティになります。このタグは、formタグ・ボディにネストされている場合のみ有効です。

対応するHTMLの<input>要素と同じように、囲んでいるフォーム要素は、method属性にPOSTを、enctype属性にmultipart/form-dataを指定する必要があります。次に例を示します。

    <html:form method="POST" enctype="multipart/form-data">
        <html:file property="theFile" />
    </html:form>    
属性名 説明
accept

送信先のサーバーが処理方法を認識している、コンテンツ・タイプのカンマ区切りのセット。このリストは、選択可能なファイル・オプションのセットを制限するためにクライアント・ブラウザで使用されます。指定しない場合、コンテンツ・タイプ・リストは送信されません。(RT EXPR)

accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

maxlength

受け入れる最大の入力文字数。[制限なし](RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。(REQUIRED)(RT EXPR)

size

表示するファイル選択ボックスのサイズ。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このボタンに表示されるラベルの値。またこの値は、指定のリクエスト・パラメータの値として送信されます。[このタグ・ボディ(存在する場合)またはCancel](RT EXPR)

Struts HTMLタグ・ライブラリ<html:form>タグ

このタグ・ボディ・コンテンツで記述されているコンテンツのHTMLの<form>要素をレンダリングします。フォームは、指定されたリクエスト・スコープBeanまたはセッション・スコープBeanと暗黙的に対話して、Beanの現在のプロパティ値を入力フィールドに移入します。

関連付けられるフォームBeanは、次のいずれかの方法で決定されます。

注意: nametypeおよびscopeの属性の使用は、お薦めできません。対応するActionMappingから適切な値が自動的に決定される方法をできるだけ使用してください。

属性名 説明
action

このフォームの送信先のURL。この値は、適切なフォームBeanとスコープを識別するための、処理対象のActionMappingの選択にも使用されます。

コントローラ・サーブレットを選択するために拡張子マッピングを使用する場合、この値は、対応する<action>要素のpath属性(オプションで正しい拡張子の接尾辞が付加される)と一致する必要があります。

コントローラ・サーブレットを選択するためにパス・マッピングを使用する場合、この値は、対応する<action>要素のpath属性と正確に一致する必要があります。

(REQUIRED)(RT EXPR)
enctype メソッドがPOSTの場合に、このフォームの送信に使用されるコンテンツ・エンコード。ファイルのアップロードを有効にするためにファイル・タグを使用する場合は、multipart/form-dataに設定する必要があります。指定しない場合、ブラウザのデフォルト(通常はapplication/x-www-form-urlencoded)が使用されます。(RT EXPR)
focus JavaScript関数によって最初にフォーカスが割り当てられるフィールド名(このフォーム内のフィールド)。指定しない場合、この目的のためにJavaScriptはレンダリングされません。(RT EXPR)
method このリクエストを送信するために使用されるHTTPメソッド(GET、POST)。[POST](RT EXPR)
name

非推奨: Bean名は、対応するActionMappingから決定されます。

リクエスト・スコープBeanまたはセッション・スコープBean(scope属性で定義される)の名前。このプロパティが、入力フィールド値の移入に使用されます。これらのBeanが存在しない場合は、type属性で指定したJavaクラス名を使用して、新しいBeanが作成され適切なスコープに追加されます。

この属性を指定しない場合、Beanの名前は、対応するActionMapping要素を参照するaction属性の値を使用して求められ、ここから指定されているフォームBean名が選択されます。

(RT EXPR)
onreset フォームがリセットされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onsubmit フォームが送信されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
scope

非推奨: Beanスコープは、対応するActionMappingから決定されます。

この入力フォームに関連付けられているフォームBeanがアクセスまたは作成されるスコープ(requestまたはsessionになります)。

この属性を指定しない場合、Beanのスコープは、対応するActionMapping要素を参照するaction属性の値を使用して求められ、ここから指定されているフォームBeanスコープが選択されます。

(RT EXPR)
style このHTML要素に適用されるCSSスタイル。(RT EXPR)
styleClass このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)
styleId このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)
target このフォームの送信先のウィンドウ・ターゲット。フレーム表示などで使用されます。(RT EXPR)
type

非推奨: Beanタイプは、対応するActionMappingから決定されます。

作成されるフォームBeanの完全修飾Javaクラス名(該当するBeanが指定のスコープで見つからない場合)。

この属性を指定しない場合、Beanのタイプは、対応するActionMapping要素を参照するaction属性の値を使用して求められ、ここから指定されているフォームBeanタイプが選択されます。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:frame>タグ

src属性の処理を含むHTMLの<frame>要素をレンダリングします。この処理は、href属性について<html:link>タグによって実行される処理と同じです。Cookieがない場合にセッション状態を保持するため、URLリライティングが自動的に適用されます。

このフレームのベースURLは、指定を行う次の属性に基づいて求められます(どれか1つを指定する必要があります)。

通常、前述の属性のいずれかを使用して指定したハイパーリンクは、変更されません(URLリライティングが必要な場合以外)。ただし、動的に定義した1つ以上の問合せパラメータをハイパーリンクに追加する方法が2つあります。paramId属性(と値を選択するための関連する属性)を含む1つのパラメータを指定する方法と、1つ以上のパラメータIDと対応する値を含むjava.util.Map Beanを選択するためのname属性(とオプションのproperty属性)を指定する方法です。

1つのパラメータを指定する場合は、paramId属性を使用して、送信するリクエスト・パラメータの名前を定義します。対応する値を指定するには、次のいずれかの方法を使用します。

ハイパーリンクに追加するすべてのリクエスト・パラメータを含むjava.util.Mapを指定する場合は、次のいずれかの方法を使用します。

Mapが処理されると、キーは、ハイパーリンクに追加される問合せパラメータの名前であるとみなされます。各キーに関連付けられている値は、パラメータ値を表す文字列または文字列配列、もしくはオブジェクト(自身のtoString()メソッドがコールされる)のいずれかになります。文字列配列が指定された場合、同じ問合せパラメータ名で複数の値が作成されます。

また、現在のトランザクションの制御トークンがある場合は、transaction属性をtrueに設定することで、生成されるハイパーリンクに制御トークンをインクルードするようにリクエストできます。また、anchor属性を使用すると、前述のいずれかの方法で作成されるURLの終わりにアンカー(#xxx)を追加するようにリクエストすることもできます。

属性名 説明
anchor

生成されるハイパーリンクにオプションとして追加するanchorタグ(#xxx)。#文字は使用せずにこの値を指定してください。

(RT EXPR)
forward

この送信先の実際のコンテンツ相対URIを含むグローバルActionForwardの論理名。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)
frameborder

このフレームの周囲にフレームの枠線を生成します(1)。または生成しません(0)。

(RT EXPR)
frameName

レンダリングされる<frame>要素のname属性の値。

(RT EXPR)
href

アクティブ化された場合に、このハイパーリンクによるコントロールのフォワード先となるURL。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)
longdesc

フレームの詳しい説明のURI。この説明は、title属性を使用して提供される短い説明を補うもので、ビジュアル環境でないユーザー・エージェントには特に役に立ちます。

(RT EXPR)
marginheight

フレームのコンテンツと上下マージンの間の余白(ピクセル単位)。

(RT EXPR)
marginwidth

フレームのコンテンツと左右マージンの間の余白(ピクセル単位)。

(RT EXPR)
name

問合せパラメータを表すMapを含むJSP Beanの名前(propertyを指定しない場合)、またはMapを返すためにコールされるプロパティgetterを含むJSP Beanの名前(propertyを指定した場合)。

(RT EXPR)
noresize

ユーザーによるフレームのサイズ変更を禁止するかどうか。(true、false)。

(RT EXPR)
page

アクティブ化された場合に、このハイパーリンクによるコントロールのフォワード先となる("/"で始まる)アプリケーション相対パス。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)
paramId

生成されるハイパーリンクに動的に追加されるリクエスト・パラメータの名前。対応する値は、paramName属性と(オプションの)paramProperty属性によって定義され、オプションとしてparamScope属性で範囲指定されます。

(RT EXPR)
paramName

paramIdで指定されるリクエスト・パラメータの値を含む、文字列であるJSP Beanの名前(paramPropertyを指定しない場合)。または文字列を返すためにコールされるプロパティgetterを含むJSP Beanの名前(paramPropertyを指定した場合)。JSP Beanは、paramScopeプロパティを指定した場合はそのBeanスコープに制限されます。

(RT EXPR)
paramProperty

paramName属性によって指定されるBeanのプロパティ名。その戻り値は、このハイパーリンクに動的に追加されるリクエスト・パラメータ(paramId属性によって指定される)の値を含む文字列となります。

(RT EXPR)
paramScope

paramName属性によって指定されたBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)
property

name属性によって指定されるBeanのプロパティ名。その戻り値は、ハイパーリンクに追加される問合せパラメータを含むjava.util.Mapとなります。この属性を指定する場合は、name属性を指定する必要があります

(RT EXPR)
scope

name属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)
scrolling

スクロール・バーを無条件に作成します(yes)、または作成しません(no)、または必要時のみ作成します(auto)。

(RT EXPR)
style

この要素に適用されるCSSスタイル。

(RT EXPR)
styleClass

この要素に適用されるCSSスタイルシート・クラス。

(RT EXPR)
styleId このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)
title

この要素の付加情報タイトル。

(RT EXPR)
titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)
transaction

trueに設定すると、現在のトランザクションの制御トークンがある場合は、生成されるハイパーリンクにそれがインクルードされ、受信側のアクションでのisTokenValid()テストにパスします。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:hidden>タグ

現在のフォームに関連付けられているBeanの指定の値またはプロパティから、非表示タイプのHTMLの<input>要素をレンダリングします。このタグは、formタグ・ボディにネストされている場合のみ有効です。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

この入力フィールドの名前。値が指定されていない場合は、対応するBeanプロパティの名前。対応するBeanプロパティがある場合は、文字列型であることが必要です。(REQUIRED)(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このフィールドを初期化する値。[対応するBeanプロパティ値を使用](RT EXPR)

write

HTMLのtype="hidden"要素の作成の他に、このフィールドの値をレスポンス・ページにレンダリングして表示するかどうか。デフォルトでは、非表示要素のみが作成されます。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:html>タグ

ユーザーの現在のロケール・オブジェクト(存在する場合)から抽出された言語属性を使用して、HTMLの<html>要素をレンダリングします。

属性名 説明
locale

現在何も設定されていない場合、現在のリクエストのAccept-Languageヘッダー(存在する場合)に基づいてロケールを記録するには、trueに設定します。

(RT EXPR)

xhtml

生成されるhtml要素にxml:lang属性をレンダリングするには、trueに設定します。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:image>タグ

imageタイプのHTMLの<input>タグをレンダリングします。このイメージのベースURLは、src属性またはpage属性に指定される値に基づいて直接的に求められるか、srcKey属性またはpageKey属性に基づくメッセージ・リソース文字列を参照して間接的に求められます。これらの属性のどれか1つを指定する必要があります

このリクエストを送信したマウス・クリックの座標を取得する場合は、次のproperty属性の情報を参照してください。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。

(RT EXPR)
align

このイメージの位置合せオプション。

(RT EXPR)
alt

このイメージの代替テキスト。

(RT EXPR)
altKey

このイメージの代替テキストのメッセージ・リソース・キー。

(RT EXPR)
border

このイメージの周囲の枠線の幅(ピクセル単位)。

(RT EXPR)
bundle

MessageResourcesインスタンスで使用されるサーブレット・コンテキスト属性キー。指定しない場合、アクション・サーブレットに対して設定されているアプリケーション・リソースがデフォルトとなります。

(RT EXPR)
disabled この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)
indexed logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)
locale

各国語メッセージを選択するために使用するロケールのセッション属性キー。指定しない場合、Struts標準値がデフォルトとなります。

(RT EXPR)
onblur (RT EXPR)
onchange (RT EXPR)
onclick (RT EXPR)
ondblclick (RT EXPR)
onfocus (RT EXPR)
onkeydown (RT EXPR)
onkeypress (RT EXPR)
onkeyup (RT EXPR)
onmousedown (RT EXPR)
onmousemove (RT EXPR)
onmouseout (RT EXPR)
onmouseover (RT EXPR)
onmouseup (RT EXPR)
page

このinputタグのイメージのアプリケーション相対パス。

(RT EXPR)
pageKey

メッセージ・リソース文字列のキー。このinputタグのイメージのアプリケーション相対パスを指定します。

(RT EXPR)
property

このimageタグのプロパティ名。リクエストのパラメータ名は、"property.x"と"property.y"として表されます。xとyは、イメージに対してマウスをクリックしたときの座標を示します。フォームBeanを介してこれらの値を取得するには、getX()、getY()、setX()およびsetY()メソッドを定義し、空文字列(property=="")としてプロパティを指定します。

(RT EXPR)
src

このinputタグのイメージのソースURL。

(RT EXPR)
srcKey

メッセージ・リソース文字列のキー。このinputタグのイメージのソースURLを指定します。

(RT EXPR)
style (RT EXPR)
styleClass (RT EXPR)
tabindex (RT EXPR)
title

この要素の付加情報タイトル。

(RT EXPR)
titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)
value

このイメージ・ボタンをクリックしたときに送信される値。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:img>タグ

指定のURLにあるイメージを含むHTMLの<img>要素をレンダリングします。linkタグと同様に、Cookieがない場合にセッション状態を保持するため、srcまたはpageに指定された値にURLリライティングが自動的に適用されます。表示コンテンツがこのタグの属性から決まるような、イメージの動的生成にも利用できます。

このイメージのベースURLは、src属性またはpage属性に指定される値に基づいて直接的に求められるか、srcKey属性またはpageKey属性に基づくメッセージ・リソース文字列を参照して間接的に求められます。これらの属性のどれか1つを指定する必要があります

通常、指定したsrcまたはpageは変更されません(URLリライティングが必要な場合以外)。ただし、動的に定義した1つ以上の問合せパラメータをsrc URLに追加する方法が2つあります。paramId属性(と値を選択するための関連する属性)を含む1つのパラメータを指定する方法と、1つ以上のパラメータIDと対応する値を含むjava.util.Map Beanを選択するためのname属性(とオプションのproperty属性)を指定する方法です。

1つのパラメータを指定する場合は、paramId属性を使用して、送信するリクエスト・パラメータの名前を定義します。対応する値を指定するには、次のいずれかの方法を使用します。

ハイパーリンクに追加するすべてのリクエスト・パラメータを含むjava.util.Mapを指定する場合は、次のいずれかの方法を使用します。

Mapが処理されるとき、キーは、src URLに追加される問合せパラメータの名前であるとみなされます。各キーに関連付けられている値は、パラメータ値を表す文字列または文字列配列、もしくはオブジェクト(自身のtoString()メソッドがコールされる)のいずれかになります。文字列配列が指定された場合、同じ問合せパラメータ名で複数の値が作成されます。

このイメージの代替テキストを指定できます(ほとんどのブラウザでは、ユーザーがイメージ上にマウスを合せたときにポップアップ・テキストとして表示されます)。alt属性を使用して直接指定するか、bundle属性とaltKey属性を使用してメッセージ・リソース・バンドルから間接的に指定します。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。

(RT EXPR)

align

イメージの位置合せ。次のいずれかの属性を指定できます。

  • left: 左寄せ。テキストは右側に回り込んで表示されます。
  • right: 右寄せ。テキストは左側に回り込んで表示されます。
  • top: 同じ行のテキストの上端にイメージの位置を合せます。
  • middle: イメージの中心をテキストのベース・ラインに合せます。
  • bottom: イメージの下端をテキストのベース・ラインに合せます。
  • texttop: イメージの上端を同じ行のテキスト・フォントの上端に合せます。
  • absmiddle: イメージの中心をテキストの中心に合せます。
  • absbottom: イメージの下端をテキスト・フォントの下端に合せます。

(RT EXPR)

alt

図形をサポートしていないブラウザで表示される代替テキスト。また、イメージ上に表示されるポップアップ・ヘルプとしても使用されます。

(RT EXPR)
altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)
border

このイメージの周囲の枠線の幅。

(RT EXPR)
bundle

MessageResourcesインスタンスで使用されるサーブレット・コンテキスト属性キー。指定しない場合、アクション・サーブレットに対して設定されているアプリケーション・リソースがデフォルトとなります。

(RT EXPR)
height

表示されるイメージの高さ。このパラメータを(widthとともに)指定すると、ブラウザでページをより速くレンダリングできるようになります。

(RT EXPR)
hspace

アイコンとテキストの水平間隔。テキストは同じ段落に表示することも、イメージを回り込んで表示することもできます。

(RT EXPR)
imageName

ページ内スクリプトで参照できるように、このページ内で定義される記述可能な名前。つまり、ここに指定する値によって、生成されるimageタグのname要素がレンダリングされます。

(RT EXPR)
ismap

このイメージが属するサーバー側マップの名前。

(RT EXPR)
locale

各国語メッセージを検索するために使用される、リクエストまたはセッションのロケール属性の名前。

(RT EXPR)
lowsrc

解像度の低いグラフィック・カードを使用しているユーザー向けのイメージ。

(RT EXPR)
name

問合せパラメータを表すMapを含むJSP Beanの名前(propertyを指定しない場合)、またはMapを返すためにコールされるプロパティgetterを含むJSP Beanの名前(propertyを指定した場合)。

(RT EXPR)
onclick この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
ondblclick この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onkeydown

この要素でキーが押された状態で実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onkeypress

この要素でキーが押されたときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onkeyup

この要素でキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onmousedown この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmousemove この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmouseout この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmouseover この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmouseup この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
page

このタグで表示されるイメージの(スラッシュで始まる)アプリケーション相対パス。このイメージに対してレンダリングされるURLには、必要なURLリライティングの他に、(linkタグのpage属性の動作と同様に)このWebアプリケーションのコンテキスト・パスが自動的に付加されます。page属性またはsrc属性を指定する必要があります

(RT EXPR)
pageKey

このイメージのアプリケーション相対パスとして使用される文字列のメッセージ・キー。bundle属性で指定されるメッセージ・リソース・バンドルにあります。

(RT EXPR)
paramId

生成されるsrc URLに動的に追加されるリクエスト・パラメータの名前。対応する値は、paramName属性と(オプションの)paramProperty属性によって定義され、オプションとしてparamScope属性で範囲指定されます。

(RT EXPR)
paramName

paramIdで指定されるリクエスト・パラメータの値を含む、文字列であるJSP Beanの名前(paramPropertyを指定しない場合)。または文字列を返すためにコールされるプロパティgetterを含むJSP Beanの名前(paramPropertyを指定した場合)。JSP Beanは、paramScopeプロパティを指定した場合はそのBeanスコープに制限されます。

(RT EXPR)
paramProperty

paramName属性によって指定されるBeanのプロパティ名。その戻り値は、このsrc URLに動的に追加されるリクエスト・パラメータ(paramId属性によって指定される)の値を含む文字列となります。

(RT EXPR)
paramScope

paramName属性によって指定されたBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)
property

name属性によって指定されるBeanのプロパティ名。その戻り値は、src URLに追加される問合せパラメータを含むjava.util.Mapとなります。この属性を指定する場合は、name属性を指定する必要があります

(RT EXPR)
scope

name属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)
src

このイメージの送信先のURL。このイメージは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。レンダリングされたタグの"src"属性の値として、この値は変更されずに使用されます(潜在的なURLリライティングは除きます)。page属性またはsrc属性を指定する必要があります

(RT EXPR)
srcKey

このイメージのURLとして使用される文字列のメッセージ・キー。bundle属性で指定されるメッセージ・リソース・バンドルにあります。

(RT EXPR)
style

この要素に適用されるCSSスタイル。

(RT EXPR)
styleClass

この要素に適用されるCSSスタイルシート・クラス。

(RT EXPR)
styleId このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)
title

この要素の付加情報タイトル。

(RT EXPR)
titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)
usemap

このイメージのホットスポット領域のマッピングのためにこのページ内に定義されているマップの名前。

(RT EXPR)
VSpace

アイコンとテキストの垂直間隔(上下)。

(RT EXPR)
width

表示されるイメージの幅。このパラメータを(heightとともに)指定すると、ブラウザでページをより速くレンダリングできるようになります。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:javascript>タグ

ValidatorPlugInによってロードされた検証規則に基づくJavaScript検証をレンダリングします。生成される検証規則のセットは、渡されるformName属性に基づいています。これは、xmlファイルのform要素のname属性と一致します。

dynamicJavascript属性およびstaticJavascript属性のデフォルトはtrueです。ただし、dynamicJavascriptをtrueに設定し、staticJavascriptをfalseに設定すると、動的JavaScriptのみがレンダリングされます。dynamicJavascriptをfalseに設定し、staticJavascriptをtrueに設定すると、静的JavaScriptのみがレンダリングされます。静的JavaScriptは、ブラウザでキャッシュできるように別のJSPページに移すことができます。
属性名 説明
dynamicJavascript

動的JavaScriptをレンダリングするかどうか。デフォルトはtrueです。

formName

特定の検証規則のセットを取得するためのキー(フォーム名)。

(RT EXPR)
method

デフォルトのかわりに使用される代替JavaScriptメソッド名。デフォルトは、渡されるキー(フォーム名)の前にvalidateが付いたものになります(例: validateRegistrationForm)。

(RT EXPR)
page

検証規則のセットの現在のページ(xmlファイルのフィールド要素のpage属性が使用中である場合)。

(RT EXPR)
src

html script要素を定義するときのsrc属性値。

(RT EXPR)
staticJavascript

静的JavaScriptをレンダリングするかどうか。デフォルトはtrueです。

Struts HTMLタグ・ライブラリ<html:link>タグ

アンカー定義(linkNameが指定される場合)または指定のURLへのハイパーリンクとして、HTMLの<a>要素をレンダリングします。Cookieがない場合にセッション状態を保持するため、URLリライティングが自動的に適用されます。このハイパーリンクに表示されるコンテンツは、このタグ・ボディから使用されます。

このハイパーリンクのベースURLは、指定を行う次の属性に基づいて求められます(どれか1つを指定する必要があります)。

通常、前述の属性のいずれかを使用して指定したハイパーリンクは、変更されません(URLリライティングが必要な場合以外)。ただし、動的に定義した1つ以上の問合せパラメータをハイパーリンクに追加する方法が2つあります。paramId属性(と値を選択するための関連する属性)を含む1つのパラメータを指定する方法と、1つ以上のパラメータIDと対応する値を含むjava.util.Map Beanを選択するためのname属性(とオプションのproperty属性)を指定する方法です。

1つのパラメータを指定する場合は、paramId属性を使用して、送信するリクエスト・パラメータの名前を定義します。対応する値を指定するには、次のいずれかの方法を使用します。

ハイパーリンクに追加するすべてのリクエスト・パラメータを含むjava.util.Mapを指定する場合は、次のいずれかの方法を使用します。

Mapが処理されると、キーは、ハイパーリンクに追加される問合せパラメータの名前であるとみなされます。各キーに関連付けられている値は、パラメータ値を表す文字列または文字列配列、もしくはオブジェクト(自身のtoString()メソッドがコールされる)のいずれかになります。文字列配列が指定された場合、同じ問合せパラメータ名で複数の値が作成されます。

また、現在のトランザクションの制御トークンがある場合は、transaction属性をtrueに設定することで、生成されるハイパーリンクに制御トークンをインクルードするようにリクエストできます。また、anchor属性を使用すると、前述のいずれかの方法で作成されるURLの終わりにアンカー(#xxx)を追加するようにリクエストすることもできます。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。

(RT EXPR)
anchor

生成されるハイパーリンクにオプションとして追加するanchorタグ(#xxx)。#文字は使用せずにこの値を指定してください。

(RT EXPR)
forward

この送信先の実際のコンテンツ相対URIを含むグローバルActionForwardの論理名。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性、linkName属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)
href

アクティブ化された場合に、このハイパーリンクによるコントロールのフォワード先となるURL。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性、linkName属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)
indexed logic:iterateタグ内でのみ有効。trueに設定すると、indexId属性の名前が付けられた索引付きパラメータが問合せ文字列に追加されます。索引付きパラメータはindex[32]のように示されます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)
indexId この属性を使用して、索引付きパラメータの名前を変更できます。詳細は、indexed属性を参照してください。(RT EXPR)
linkName

このページ内で定義されるアンカー名。ページ内ハイパーリンクで参照できます。つまり、ここに指定する値によって、生成されるanchorタグの"name"要素がレンダリングされます。

(RT EXPR)
name

問合せパラメータを表すMapを含むJSP Beanの名前(propertyを指定しない場合)、またはMapを返すためにコールされるプロパティgetterを含むJSP Beanの名前(propertyを指定した場合)。

(RT EXPR)
onblur

この要素が入力フォーカスを失った場合に実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onfocus

この要素が入力フォーカスを取得した場合に実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onkeydown

この要素でキーが押された状態で実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onkeypress

この要素でキーが押されたときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onkeyup

この要素でキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onmousedown

この要素がマウス・ボタンで押された状態のときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onmousemove

この要素上でマウスが移動したときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onmouseout

この要素外にマウスが移動したときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onmouseover

この要素内にマウスが移動したときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
onmouseup

この要素でマウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。

(RT EXPR)
page

アクティブ化された場合に、このハイパーリンクによるコントロールのフォワード先となる("/"で始まる)アプリケーション相対パス。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性、linkName属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)
paramId

生成されるハイパーリンクに動的に追加されるリクエスト・パラメータの名前。対応する値は、paramName属性と(オプションの)paramProperty属性によって定義され、オプションとしてparamScope属性で範囲指定されます。

(RT EXPR)
paramName

paramIdで指定されるリクエスト・パラメータの値を含む、文字列であるJSP Beanの名前(paramPropertyを指定しない場合)。または文字列を返すためにコールされるプロパティgetterを含むJSP Beanの名前(paramPropertyを指定した場合)。JSP Beanは、paramScopeプロパティを指定した場合はそのBeanスコープに制限されます。

(RT EXPR)
paramProperty

paramName属性によって指定されるBeanのプロパティ名。その戻り値は、このハイパーリンクに動的に追加されるリクエスト・パラメータ(paramId属性によって指定される)の値を含む文字列となります。

(RT EXPR)
paramScope

paramName属性によって指定されたBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)
property

name属性によって指定されるBeanのプロパティ名。その戻り値は、ハイパーリンクに追加される問合せパラメータを含むjava.util.Mapとなります。この属性を指定する場合は、name属性を指定する必要があります

(RT EXPR)
scope

name属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)
style

この要素に適用されるCSSスタイル。

(RT EXPR)
styleClass

この要素に適用されるCSSスタイルシート・クラス。

(RT EXPR)
styleId このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)
tabindex

この要素のタブ順序(昇順の正の整数)。

(RT EXPR)
target

たとえば、フレーム表示の場合に、このハイパーリンクでリクエストされるリソースが表示されるウィンドウ・ターゲット。

(RT EXPR)
title

このハイパーリンクの付加情報を示すタイトル。

(RT EXPR)
titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)
transaction

trueに設定すると、現在のトランザクションの制御トークンがある場合は、生成されるハイパーリンクにそれがインクルードされ、受信側のアクションでのisTokenValid()テストにパスします。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:messages>タグ

ビジネス・ロジック・コンポーネントで用意され、ActionMessagesオブジェクト、ActionErrorsオブジェクト、文字列または文字列配列としてリクエスト・スコープに格納されているメッセージのセットが表示されます。このようなBeanが検出されない場合は、何もレンダリングされません。

このタグを適切に使用するには、アプリケーション・スコープMessageResources Beanをデフォルト属性名の下に定義しておく必要があります。

属性名 説明
bundle

MessageResourcesインスタンスで使用されるサーブレット・コンテキスト属性キー。指定しない場合、アクション・サーブレットに対して設定されているアプリケーション・リソースがデフォルトとなります。(RT EXPR)

footer

この値は、オプションのメッセージ・リソース・キーです。メッセージの反復が終了した後で表示されます。(RT EXPR)

header

この値は、オプションのメッセージ・リソース・キーです。メッセージの反復が開始する前に表示されます。(RT EXPR)

id

ページ・スコープJSP Beanの名前。nullでない場合は、反復のたびにメッセージのコレクションの現在の要素を含みます。(REQUIRED)(RT EXPR)

locale

表示されるメッセージの選択に使用するロケールのセッション属性キー。指定しない場合、Struts標準値がデフォルトとなります。(RT EXPR)

message

デフォルトでは、このタグは、反復するリクエスト・スコープBeanをAction.ERROR_KEY定数文字列から取得します。ただし、この属性をtrueに設定すると、リクエスト・スコープBeanはAction.MESSAGE_KEY定数文字列から取得されます。また、trueに設定すると、name属性に割り当てられている値はすべて無視されます。(RT EXPR)

name

メッセージが格納されているリクエスト・スコープBeanの名前。存在しない場合は、Action.ERROR_KEY定数文字列で指定された名前が使用されます。(RT EXPR)

property

メッセージの表示対象のプロパティの名前。指定しない場合、すべてのメッセージが(プロパティに関係なく)表示されます。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:multibox>タグ

checkboxタイプのHTMLの<input>要素をレンダリングします。このチェックされている場合の状態は、指定の値が、基礎となるプロパティの現在値の配列のいずれかの要素と一致しているかどうかに基づいて初期化されます。このタグは、多数のチェック・ボックスがあるときに、複数のブール型プロパティではなく、値を組み合せて1つの配列値プロパティを使用する場合に有用です。このタグは、formタグ・ボディにネストされている場合のみ有効です。

警告: 関連するチェック・ボックスがまったく選択されていない状態を正しく認識するには、このフォームに関連付けられているActionForm Beanが、対応する配列をreset()メソッドで長さゼロに設定する文を、インクルードする必要があります。

このチェック・ボックスが選択されている場合にサーバーに返される値は、次のいずれかの方法で定義する必要があります。

属性名 説明
accesskey この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)
alt

この要素の代替テキスト。

(RT EXPR)
altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)
disabled この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)
name Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)
onblur この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onchange この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onclick この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
ondblclick この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onfocus この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onkeydown この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onkeypress この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onkeyup この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmousedown この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmousemove この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmouseout この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmouseover この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
onmouseup この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)
property 指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。(REQUIRED)(RT EXPR)
style このHTML要素に適用されるCSSスタイル。(RT EXPR)
styleClass このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)
styleId このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)
tabindex この要素のタブ順序(昇順の正の整数)。(RT EXPR)
title

この要素の付加情報タイトル。

(RT EXPR)
titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)
value このチェック・ボックスがチェックされているとき、フォームの送信時に送られる値。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:option>タグ

<select>要素に囲まれた選択肢の1つを表す、HTMLの<option>要素をレンダリングします。ユーザーに対して表示されるテキストには、このタグ・ボディ、またはbundlelocaleおよびkey属性に基づいて検索されたメッセージ文字列が使用されます。

対応するBeanプロパティの値が、指定の値と一致する場合、このオプションは選択済としてマークされます。このタグは、<html:select>タグ・ボディにネストされている場合のみ有効です。

属性名 説明
bundle

MessageResourcesインスタンスで使用されるサーブレット・コンテキスト属性キー。指定しない場合、アクション・サーブレットに対して設定されているアプリケーション・リソースがデフォルトとなります。(RT EXPR)

disabled

このオプションを無効にする場合は、trueに設定します。(RT EXPR)

key

指定する場合、このオプションでユーザーに表示されるテキストについて、bundleによって指定されるリソース・バンドル内で検索するメッセージ・キーが定義されます。指定しない場合、表示されるテキストはこのタグ・ボディ・コンテンツから使用されます。(RT EXPR)

locale

key属性によって指定したメッセージの検索のために使用する、ロケール・インスタンスのセッション属性キー。指定しない場合、標準のStrutsセッション属性名が使用されます。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

value

このオプションがユーザーに選択された場合に、このフィールドについて送信される値。(REQUIRED)(RT EXPR)

Struts HTMLタグ・ライブラリ<html:options>タグ

<select>要素の選択肢を表す、HTMLの<option>要素のセットをレンダリングします。このタグは、1つの<html:select>要素の中で何度も使用できます。1つ以上の<html:option>要素または<html:optionsCollection>要素のかわりに使用するか、これらの要素と組み合せて使用できます。

このタグは、collection属性が指定されているかどうかによって、2つのモードで動作します。collection属性を指定した場合は、次の規則が適用されます。

collection属性を指定しない場合、次の規則が適用されます。

実際に選択される値のコレクションは、name属性とproperty属性が指定されるかどうかによって異なります。次の組合せが可能です。

ユーザーに表示されるラベルのコレクションは、オプション値と同じにすることも変えることもできます。これは、labelName属性とlabelProperty属性を指定するかどうかによって決まります。この機能を使用する場合、ラベルのコレクションの要素は、対応する値のコレクションと同じ数であることが必要です。次の組合せが可能です。

属性名 説明
collection

JSP Beanの名前(一部のスコープ)。このBean自体は、他のBeanのコレクションであり、それぞれのプロパティはproperty属性とlabelProperty属性によって指定されます。また、これらの属性は各オプションの値とラベルを取得するために使用されます。(RT EXPR)

filter

HTMLでの表示に問題がある文字についてオプション・ラベルをフィルタリングしない場合は、falseに設定します。デフォルトでは、そのような値はフィルタリングされます。(RT EXPR)

labelName

これらのオプションについてユーザーに表示されるラベルのコレクションを含むJSP Beanの名前(一部のスコープ)。(RT EXPR)

labelProperty

フォームBeanのプロパティ、またはlabelName属性によって指定されるBeanのプロパティ。これらのオプションについてユーザーに表示されるラベルのコレクションを返します。(RT EXPR)

name

これらのオプションについてサーバーに返される値のコレクションを含むJSP Beanの名前(一部のスコープ)。指定しない場合、フォームに関連付けられているフォームBeanが使用されます。(RT EXPR)

property

フォームBeanのプロパティ、またはname属性によって指定されるBeanのプロパティ。これらのオプションについてサーバーに返される値のコレクションを返します。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:optionsCollection>タグ

<select>要素の選択肢を表す、HTMLの<option>要素のセットをレンダリングします。このタグは、1つの<html:select>要素の中で何度も使用できます。1つ以上の<html:option>要素または<html:options>要素のかわりに使用するか、これらの要素と組み合せて使用できます。

このタグは、各BeanにlabelプロパティとvalueプロパティがあるBeanのコレクションに対して動作します。これらのプロパティの実際の名前は、このタグのlabel属性とvalue属性を使用して構成できます。

このタグが<html:options>タグと異なるのは、name属性とproperty属性の使用方法の一貫性が高く、囲んでいるフォームBeanからコレクションをさらに容易に取得できる点です。

属性名 説明
filter

HTMLでの表示に問題がある文字についてオプション・ラベルをフィルタリングしない場合は、falseに設定します。デフォルトでは、そのような値はフィルタリングされます。(RT EXPR)

label

各オプションについてレンダリングされるラベルを表すコレクション内のBeanのプロパティ。デフォルトはlabelです。(RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

property

フォームBeanのプロパティ、またはname属性によって指定されるBeanのプロパティ。これらのオプションについてレンダリングされるオブジェクトのコレクションを返します。(REQUIRED)(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

value

各オプションについてレンダリングされる値を表すコレクション内のBeanのプロパティ。デフォルトはvalueです。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:password>タグ

現在のフォームに関連付けられているBeanの指定の値またはプロパティから、パスワード・タイプのHTMLの<input>要素をレンダリングします。このタグは、formタグ・ボディにネストされている場合のみ有効です。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

maxlength

受け入れる最大の入力文字数。[制限なし](RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。(REQUIRED)(RT EXPR)

readonly

この入力フィールドを読取り専用にする場合は、trueに設定します。(RT EXPR)

redisplay

既存の値があるときに再表示するかどうかを示すブール型フラグ。HTMLページ上に再表示される値がアスタリスクで表示される場合でも、実際のパスワード値のクリアテキストは、クライアント・ブラウザのページ・ソースを表示するメニュー・オプションを介して表示できます。ログイン・ページでこの値をfalseに設定できます。コンテンツを再表示する他のすべてのformタグと統一するため、デフォルトはtrueになります。(RT EXPR)

size

割り当てる文字数。[ブラウザのデフォルト](RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このボタンに表示されるラベルの値。またこの値は、指定のリクエスト・パラメータの値として送信されます。[このタグ・ボディ(存在する場合)またはCancel](RT EXPR)

Struts HTMLタグ・ライブラリ<html:radio>タグ

現在のフォームに関連付けられているBeanの指定のプロパティから、ラジオ・タイプのHTMLの<input>要素をレンダリングします。このタグは、formタグ・ボディにネストされている場合のみ有効です。

一連のradioタグをレンダリングするためにイテレータを使用する場合は、idName属性を使用して、イテレータで公開するBeanの名前を指定できます。この場合、この反復でradioタグを返すidName Beanにおいて、value属性がプロパティの名前として使用されます。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

idName

Struts 1.1以上。

radioタグの値を返すBeanの名前(一部のスコープ内)。通常はイテレータによって公開されます。idName属性が存在するとき、この反復でradioタグを返すidName Beanにおいて、value属性がプロパティの名前として使用されます。

(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

このradioタグに対応するBeanプロパティ。(REQUIRED)(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

radioタグの値。(REQUIRED)(RT EXPR)

Struts HTMLタグ・ライブラリ<html:reset>タグ

resetタイプのHTMLの<input>要素をレンダリングします。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

生成される入力フィールドの名前。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このボタンに表示されるラベルの値。[このタグ・ボディ(存在する場合)またはReset](RT EXPR)

Struts HTMLタグ・ライブラリ<html:rewrite>タグ

linkタグとまったく同じ規則に基づいてリクエストURIをレンダリングします。ただし、<a>ハイパーリンクは作成されません。この値は、JavaScriptプロシージャで使用するための文字列定数を生成する場合に便利です。

属性名 説明
anchor

生成されるハイパーリンクにオプションとして追加するanchorタグ(#xxx)。#文字は使用せずにこの値を指定してください。

(RT EXPR)

forward

この送信先の実際のコンテンツ相対URIを含むグローバルActionForwardの論理名。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)

href

アクティブ化された場合に、このハイパーリンクによるコントロールのフォワード先となるURL。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)

name

問合せパラメータを表すMapを含むJSP Beanの名前(propertyを指定しない場合)、またはMapを返すためにコールされるプロパティgetterを含むJSP Beanの名前(propertyを指定した場合)。

(RT EXPR)

page

アクティブ化された場合に、このハイパーリンクによるコントロールのフォワード先となる(スラッシュで始まる)アプリケーション相対パス。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。forward属性、href属性またはpage属性のどれか1つを指定する必要があります

(RT EXPR)

paramId

生成されるハイパーリンクに動的に追加されるリクエスト・パラメータの名前。対応する値は、paramName属性と(オプションの)paramProperty属性によって定義され、オプションとしてparamScope属性で範囲指定されます。

(RT EXPR)

paramName

paramIdで指定されるリクエスト・パラメータの値を含む、文字列であるJSP Beanの名前(paramPropertyを指定しない場合)。または文字列を返すためにコールされるプロパティgetterを含むJSP Beanの名前(paramPropertyを指定した場合)。JSP Beanは、paramScopeプロパティを指定した場合はそのBeanスコープに制限されます。

(RT EXPR)

paramProperty

paramName属性によって指定されるBeanのプロパティ名。その戻り値は、このハイパーリンクに動的に追加されるリクエスト・パラメータ(paramId属性によって指定される)の値を含む文字列となります。

(RT EXPR)

paramScope

paramName属性によって指定されたBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)

property

name属性によって指定されるBeanのプロパティ名。その戻り値は、ハイパーリンクに追加される問合せパラメータを含むjava.util.Mapとなります。この属性を指定する場合は、name属性を指定する必要があります

(RT EXPR)

scope

name属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。

(RT EXPR)

transaction

trueに設定すると、現在のトランザクションの制御トークンがある場合は、生成されるハイパーリンクにそれがインクルードされ、受信側のアクションでのisTokenValid()テストにパスします。

(RT EXPR)

Struts HTMLタグ・ライブラリ<html:select>タグ

属性によって指定するBeanプロパティに関連付けられているHTMLの<select>要素をレンダリングします。このタグは、formタグ・ボディにネストされている場合のみ有効です。

このタグは、multiple属性(使用する関連プロパティのデータ型に影響する)の状態によって、2つのモードで動作します。

警告: 何も選択されていない状態を正しく認識するには、このフォームに関連付けられているActionForm Beanが、スカラー・プロパティをデフォルト値にリセットする(multipleが設定されない場合)文か、配列プロパティをreset()メソッドで長さゼロにリセットする(multipleが設定される場合)文を、インクルードする必要があります。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

multiple

任意の値に設定すると、レンダリングされる選択要素で複数の選択肢がサポートされます。(RT EXPR)

name

Beanの属性名。この入力フィールドをレンダリングするときに事前選択状態にするオプションを決めるために、プロパティが参照されます。指定しない場合、囲んでいる<html:form>タグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。(REQUIRED)(RT EXPR)

size

同時に表示できるオプションの数。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

オプションを選択済としてマークするときに比較する値。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:submit>タグ

送信タイプの入力ボタンをレンダリングします。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がpropertyName[34]のようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

指定の値に設定され、この送信に含められるリクエスト・パラメータの名前。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

ボタン・ラベルの値。(RT EXPR)

Struts HTMLタグ・ライブラリ<html:text>タグ

テキスト・タイプの入力ボタンをレンダリングします。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

maxlength

受け入れる最大の入力文字数。[制限なし](RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

この入力フィールドの名前。値が指定されていない場合は、対応するBeanプロパティの名前。対応するBeanプロパティがある場合は、文字列型であることが必要です。(REQUIRED)(RT EXPR)

readonly

この入力フィールドを読取り専用にする場合は、trueに設定します。(RT EXPR)

size

割り当てる文字数。[ブラウザのデフォルト](RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このフィールドを初期化する値。[対応するBeanプロパティ値を使用](RT EXPR)

Struts HTMLタグ・ライブラリ<html:textarea>タグ

TextArea要素をレンダリングします。

属性名 説明
accesskey

この要素にすぐにフォーカスを移動するために使用する文字キー。(RT EXPR)

alt

この要素の代替テキスト。

(RT EXPR)

altKey

この要素の代替テキストのメッセージ・リソース・キー。

(RT EXPR)

cols

表示する列数。(RT EXPR)

disabled

この入力フィールドを無効にする場合は、trueに設定します。(RT EXPR)

indexed

logic:iterateタグ内でのみ有効。trueに設定すると、htmlタグの名前がid[34].propertyNameのようにレンダリングされます。カッコ内の数値は、親のlogic:iterateタグから開始し反復のたびに生成されます。(RT EXPR)

name

Beanの属性名。この入力フィールドの現在の値をレンダリングするときに、このBeanのプロパティが調べられます。指定しない場合、ネストされているformタグに関連付けられているBeanが利用されます。(RT EXPR)

onblur

この要素が入力フォーカスを失ったときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onchange

この要素が入力フォーカスを失い値が変更されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onclick

この要素がマウスでクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

ondblclick

この要素がマウスでダブルクリックされたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onfocus

この要素が入力フォーカスを得たときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeydown

この要素がフォーカスを得てキーが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeypress

この要素がフォーカスを得て、キーが押されてから放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onkeyup

この要素がフォーカスを得てキーが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousedown

この要素にマウス・ポインタがある状態で、マウス・ボタンが押された状態のときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmousemove

この要素にマウス・ポインタがある状態で、ポインタが移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseout

この要素にマウス・ポインタがある状態だったが、ポインタが要素外に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseover

この要素にマウス・ポインタがない状態だったが、ポインタが要素内に移動したときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

onmouseup

この要素にマウス・ポインタがある状態で、マウス・ボタンが放されたときに実行されるJavaScriptのイベント・ハンドラ。(RT EXPR)

property

この入力フィールドの名前。値が指定されていない場合は、対応するBeanプロパティの名前。対応するBeanプロパティがある場合は、文字列型であることが必要です。(REQUIRED)(RT EXPR)

readonly

この入力フィールドを読取り専用にする場合は、trueに設定します。(RT EXPR)

rows

表示する行数。(RT EXPR)

style

このHTML要素に適用されるCSSスタイル。(RT EXPR)

styleClass

このHTML要素に適用されるCSSスタイルシート・クラス。(RT EXPR)

styleId

このHTML要素に割り当てられる識別子(id属性をレンダリングします)。(RT EXPR)

tabindex

この要素のタブ順序(昇順の正の整数)。(RT EXPR)

title

この要素の付加情報タイトル。

(RT EXPR)

titleKey

この要素の付加情報タイトルのメッセージ・リソース・キー。

(RT EXPR)

value

このフィールドを初期化する値。[対応するBeanプロパティ値を使用](RT EXPR)

Struts HTMLタグ・ライブラリ<html:xhtml>タグ

ページ内でこのタグを使用して、XHTML 1.0としてレンダリングすることをHTMLタグ・ライブラリの他のすべてのhtmlタグに示します。これは、JSPのインクルードまたはタイルを備えたページを構成する場合に便利です。<html:html xhtml="true">と同様の効果があります。このタグには属性はありません。<html:xhtml/>のように使用します。

注意: インクルードされるページは、インクルードしているページのレンダリング・スタイルを継承しません。各JSPフラグメントまたはタイルでは、このタグを使用してXHTMLとしてレンダリングする必要があります。


Copyright (c) 2000-2002, Apache Software Foundation

JDeveloperのStrutsカスタム・タグ・ライブラリについて
リファレンス: Strutsタグ・ライブラリ