Struts Html - <html:img>タグ

HTMLのイメージ・タグをレンダリングします。

属性

accesskey
この要素にすぐにフォーカスを移動するために使用する文字キー。
align
イメージの位置合せ。次のいずれかの属性を指定できます。
alt
この要素の代替テキスト。
altKey
この要素の代替テキストのメッセージ・リソース・キー。
border
このイメージの周囲の枠線の幅。
bundle
MessageResourcesインスタンスで使用されるサーブレット・コンテキスト属性キー。指定しない場合、アクション・サーブレットに対して設定されているアプリケーション・リソースがデフォルトとなります。
height
表示されるイメージの高さ。 このパラメータを(widthとともに)指定すると、ブラウザでページをより速くレンダリングできるようになります。
hspace
アイコンとテキストの水平間隔。テキストは同じ段落に表示することも、イメージを回り込んで表示することもできます。
imageName
ページ内スクリプトで参照できるように、このページ内で定義される記述可能な名前。 つまり、ここに指定する値によって、生成されるimageタグのname要素がレンダリングされます。
ismap
このイメージが属するサーバー側マップの名前。
locale
各国語メッセージを検索するために使用される、リクエストまたはセッションのロケール属性の名前。
locale
各国語メッセージを選択するために使用される、ロケールのセッション属性キー。指定しない場合、Struts標準値がデフォルトとなります。
lowsrc
解像度の低いグラフィック・カードを使用しているユーザー向けのイメージ。
name
問合せパラメータを表すMapを含むJSP Beanの名前(propertyを指定しない場合)、またはMapを返すためにコールされるプロパティ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
このタグで表示されるイメージの(スラッシュで始まる)アプリケーション相対パス。 このイメージに対してレンダリングされるURLには、必要なURLリライティングが行われる他に、(linkタグのpage属性の動作と同様に)このWebアプリケーションのコンテキスト・パスが自動的に付加されます。 page属性またはsrc属性を指定する必要があります。
pageKey
このイメージのアプリケーション相対パスとして使用される文字列のメッセージ・キー。bundle属性で指定されるメッセージ・リソース・バンドルにあります。
paramId
生成されるsrc URLに動的に追加されるリクエスト・パラメータの名前。 対応する値は、paramName属性と(オプションの)paramProperty属性によって定義され、オプションとしてparamScope属性で範囲指定されます。
paramName
paramIdで指定されるリクエスト・パラメータの値を含む、文字列であるJSP Beanの名前(paramPropertyを指定しない場合)。または文字列を返すためにコールされるプロパティgetterを含むJSP Beanの名前(paramPropertyを指定した場合)。JSP Beanは、paramScopeプロパティを指定した場合はそのBeanスコープに制限されます。
paramProperty
paramName属性によって指定されるBeanのプロパティ名。その戻り値は、このsrc URLに動的に追加されるリクエスト・パラメータ(paramId属性によって指定される)の値を含む文字列となります。
paramScope
paramName属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。
property
name属性によって指定されるBeanのプロパティ名。その戻り値は、src URLに追加される問合せパラメータを含むjava.util.Mapとなります。 この属性を指定する場合は、name属性を指定する必要があります。
scope
name属性によって指定されるBeanを検索するスコープ。指定しない場合、すべてのスコープが検索されます。
src
このイメージの送信先のURL。このイメージは、タグの記述どおりに、問合せパラメータのインクルードによって動的に変更される場合があります。 レンダリングされたタグのsrc属性の値として、この値は変更されずに使用されます(潜在的なURLリライティングは除きます)。 page属性またはsrc属性を指定する必要があります。
srcKey
このイメージのURLとして使用される文字列のメッセージ・キー。bundle属性で指定されるメッセージ・リソース・バンドルにあります。
style
このHTML要素に適用されるCSSスタイル。
styleClass
このHTML要素に適用されるCSSスタイルシート・クラス。
styleId
このHTML要素に割り当てられる識別子(id属性をレンダリングします)。
title
この要素の付加情報タイトル。
titleKey
この要素の付加情報タイトルのメッセージ・リソース・キー。
usemap
このイメージのホットスポット領域のマッピングのためにこのページ内に定義されているマップの名前。
vspace
アイコンとテキストの垂直間隔(上下)。
width
表示されるイメージの幅。 このパラメータを(heightとともに)指定すると、ブラウザでページをより速くレンダリングできるようになります。

説明

指定の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属性を使用してメッセージ・リソース・バンドルから間接的に指定します。


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

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

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

 

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