apex:image
HTML <img> タグで表示される画像です。
このコンポーネントを使用して、sObject の項目に対応しないコントローラメソッドのユーザ入力を取得します。sObject 項目で使用できるのは、<apex:inputfield> と apex:outfield のみです。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、生成された <img> タグに適用されます。
例
1<apex:image id="theImage" value="/img/myimage.gif" width="220" height="55" alt="Description of image here"/>上述の例では次の HTML を表示します。
1<img id="theImage" src="/img/myimage.gif" width="220" height="55" alt="Description of image here"/>リソースの例
1<apex:image id="theImage" value="{!$Resource.myResourceImage}" width="200" height="200" alt="Description of image here"/>上述の例では次の HTML を表示します。
1<img id="theImage" src="<generatedId>/myResourceImage" width="200" height="200" alt="Description of image here"/>Zip リソースの例
1<apex:image url="{!URLFOR($Resource.TestZip, 'images/Bluehills.jpg')}" width="50" height="50" alt="Description of image here"/>上述の例では次の HTML を表示します。
1<id="theImage" src="[generatedId]/images/Bluehills.jpg" width="50" height="50" alt="Description of image here"/>IMAGEPROXYURL の例
1<apex:image id="theImage" value="{!IMAGEPROXYURL('http://somedomain.com/pic.png')}" alt="Description of image here"/>上述の例では次の HTML を表示します。
1<img id="theImage" src="https://img.d.forceusercontent.com?url=http://somedomain.com/pic.png&hash=...." alt="Description of image here"/>属性
| 属性名 | 属性型 | 説明 | 必須かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| alt | String | セクション 508 に準拠するために使用される画像の代替テキストの説明。 | 10.0 | グローバル | |
| dir | String | 生成された HTML コンポーネントの読み取り方向。使用可能な値には「RTL」 (右から左) または「LTR」 (左から右) があります。 | 10.0 | グローバル | |
| height | String | この画像が表示される高さ。利用可能な縦方向の合計スペースに対する相対パーセント (height="50%" など)、またはピクセル数 (height="100px" など) のいずれかとして表されます。指定されていない場合、この値はデフォルトの取得元画像ファイルのサイズに設定されます。 | 10.0 | グローバル | |
| id | String | ページの他のコンポーネントが画像コンポーネントを参照できるようにする識別子。 | 10.0 | グローバル | |
| ismap | Boolean | この画像を画像マップとして使用するかどうかを指定する boolean 値。true に設定されている場合、画像コンポーネントは commandLink コンポーネントの子である必要があります。指定されていない場合、この値はデフォルトの false に設定されます。 | 10.0 | グローバル | |
| lang | String | 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| longdesc | String | 画像の詳細説明へのリンクの URL。 | 10.0 | グローバル | |
| onclick | String | onclick イベントが発生した場合 (ユーザが画像をクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| ondblclick | String | ondblclick イベントが発生した場合 (ユーザが画像をダブルクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeydown | String | onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeypress | String | onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeyup | String | onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousedown | String | onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousemove | String | onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseout | String | onmouseout イベントが発生した場合 (ユーザが画像からマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseover | String | onmouseover イベントが発生した場合 (ユーザが画像にマウスポインタを重ねた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseup | String | onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| rendered | Boolean | コンポーネントをページ��表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| style | String | 画像コンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 | 10.0 | グローバル | |
| styleClass | String | 画像コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| title | String | ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 | 10.0 | グローバル | |
| url | String | 表示されている画像へのパス。URL または静的リソースかドキュメントの差し込み項目のいずれかとして表されます。 | 10.0 | グローバル | |
| usemap | String | この要素が画像を提供するクライアント側の画像マップ (HTML マップ要素) の名前。 | 10.0 | グローバル | |
| value | Object | 表示されている画像へのパス。URL または静的リソースかドキュメントの差し込み項目のいずれかとして表されます。 | 10.0 | グローバル | |
| width | String | この画像が表示される幅。利用可能な横方向の合計スペースに対する相対パーセント (width="50%" など)、またはピクセル数 (width="100px" など) のいずれかとして表されます。指定されていない場合、この値はデフォルトの供給元画像ファイルのサイズに設定されます。 | 10.0 | グローバル |