Struts Html - <html:frame>タグ

HTMLフレーム要素をレンダリングします。

属性

anchor
生成されるハイパーリンクにオプションとして追加するanchorタグ(#xxx)。 #文字は使用せずにこの値を指定してください。
forward
この送信先の実際のコンテンツ相対URIを含むグローバルActionForwardの論理名。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。 forward属性、href属性、linkName属性またはpage属性のどれか1つを指定する必要があります。
frameborder
周囲にフレームの枠線を生成します(1)。または生成しません(0)。
frameName
レンダリングされる<frame>要素のname属性の値。
href
アクティブ化された場合に、このハイパーリンクが制御をフォワードする先となるURL。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。 forward属性、href属性、linkName属性またはpage属性のどれか1つを指定する必要があります。
longdesc
フレームの詳しい説明のURI。この説明は、title属性を使用して提供される短い説明を補うもので、ビジュアル環境でないユーザー・エージェントには特に役に立ちます。
marginheight
フレームのコンテンツと上下マージンの間の余白(ピクセル単位)。
marginwidth
フレームのコンテンツと左右マージンの間の余白(ピクセル単位)。
name
問合せパラメータを表すMapを含むJSP Beanの名前(propertyを指定しない場合)、またはMapを返すためにコールされるプロパティgetterを含むJSP Beanの名前(propertyを指定した場合)。
noresize
ユーザーによるフレームのサイズ変更を禁止するかどうか。(true、false)。
page
アクティブ化された場合に、このハイパーリンクによるコントロールのフォワード先となる(/で始まる)アプリケーション相対パス。このハイパーリンクは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。 forward属性、href属性、linkName属性またはpage属性のどれか1つを指定する必要があります。
paramId
生成されるハイパーリンクに動的に追加されるリクエスト・パラメータの名前。 対応する値は、paramName属性と(オプションの)paramProperty属性によって定義され、オプションとしてparamScope属性で範囲指定されます。
paramName
paramIdで指定されるリクエスト・パラメータの値を含む、文字列であるJSP Beanの名前(paramPropertyを指定しない場合)。または文字列を返すためにコールされるプロパティgetterを含むJSP Beanの名前(paramPropertyを指定した場合)。JSP Beanは、paramScopeプロパティを指定した場合はそのBeanスコープに制限されます。
paramProperty
paramName属性によって指定されるBeanのプロパティ名。その戻り値は、このハイパーリンクに動的に追加されるリクエスト・パラメータ(paramId属性によって指定される)の値を含む文字列となります。
paramScope
paramName属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。
property
name属性によって指定されるBeanのプロパティ名。その戻り値は、ハイパーリンクに追加される問合せパラメータを含むjava.util.Mapとなります。 この属性を指定する場合は、name属性を指定する必要があります。
scope
name属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。
scrolling
スクロール・バーを無条件に作成します(yes)、または作成しません(no)、または必要時のみ作成します(auto)。
style
このHTML要素に適用されるCSSスタイル。
styleClass
このHTML要素に適用されるCSSスタイルシート・クラス。
styleId
このHTML要素に割り当てられる識別子(id属性をレンダリングします)。
title
このハイパーリンクの付加情報を示すタイトル。
titleKey
この要素の付加情報タイトルのメッセージ・リソース・キー。
transaction
trueに設定すると、現在のトランザクションの制御トークンがある場合は、生成されるハイパーリンクにそれがインクルードされるので、受信側のアクションでのisTokenValid()テストにパスします。

説明

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)を追加するようにリクエストすることもできます。


JDeveloperのStrutsカスタム・タグ・ライブラリについて

リファレンス: Strutsタグ・ライブラリ

リファレンス: Struts Htmlタグ・ライブラリ

 

Copyright © 1997, 2004, Oracle. All rights reserved.