JSF 1.2 画像コンポーネントの「プロパティー」ウィンドウ
関連項目
ビジュアルデザイナーで編集中のページで画像コンポーネント を選択すると、そのプロパティーが「プロパティー」ウィンドウに表示されます。
このコンポーネントのプロパティーの大部分は、ページ Bean では Image Java コンポーネントの JSP 属性およびプロパティーの両方になります。
この JavaServer Faces 1.2 コンポーネントには、次のプロパティーがあります。
「一般」
id。 型: String
ページ Bean および JSP ファイルでの画像コンポーネントの名前。
Appearance
align。 型: String
ページのコンテキストに対する画像の位置。ドロップダウンリストから位置を選択して、ほかのコンポーネントと画像を配置します。
border。 型: int
画像のボーダーの幅をピクセル単位で指定します。このプロパティーのデフォルト値は、クライアントのブラウザによって異なります。
height。 型: int
画像を実際の高さで表示しない場合は、画像を表示する高さをピクセル単位で設定します。HTML では、<img> タグの height 属性に相当します。この設定が適用されないブラウザもあります。
icon。 型: String
独自の画像ファイルを指定せずに、テーマから画像を選択できます。イメージファイルではなくアイコンを使用する場合は、「url」プロパティーが設定されていないことを確認してください。 style。 型: String
コンポーネントに適用する階層式スタイルシートの規則 (CSS レベル 2)。例:
position: absolute; left: 288px; top: 312px
値を直接入力するか、省略符号ボタン (...) をクリックしてスタイルエディタ を使用して入力します。
このプロパティーは、このコンポーネントのテーマまたはプロジェクトの CSS ファイルの設定をオーバーライドします。コンポーネントの一部が、別のスタイル設定の子コンポーネントによって隠されていると、このプロパティーに指定されているスタイルが適用されていないように見えることがあります。
CSS2 スタイル属性の一覧は、次の Web ページを参照してください。
styleClass。 型: String コンポーネントの生成時に適用する CSS スタイルクラスの空白区切りのリスト。スタイルクラスは、プロジェクトのスタイルシートまたはテーマの CSS ファイル内で定義されている必要があります。省略符号ボタン (...) を押すと、このプロパティーに追加できるすべてのスタイルが表示されます。プロジェクトの階層式スタイルシートに CSS のクラスや規則を追加する方法については、CSS エディタ を参照してください。
このプロパティーに追加されたクラスが、コンポーネントに対して効果がないように見えることがあります。このように見える理由については、上記の「style」プロパティーの注を参照してください。
url。 型: String
画像ファイルのパス、または画像のパスを示すオブジェクトにバインドする式。このプロパティーと「icon」プロパティーの両方が設定されている場合、このプロパティーは「icon」プロパティーをオーバーライドします。省略符号ボタン (...) をクリックしてオブジェクトにバインドしたり、値を指定して画像ファイルに移動し、それをプロジェクトにインポートしたりできます。Web 上の画像の URL を指定することもできます。たとえば、/resources/image-file.gif ファイルを参照したり、次のような URL で画像を参照できます。
width。 型: int
画像を実際の幅で表示しない場合は、画像を表示する幅をピクセル単位で設定します。HTML では、<img> タグの width 属性に相当します。この設定が適用されないブラウザもあります。
動作
toolTip。 型: String
コンポーネントの HTML の title 属性になります。スクリーンリーダーで読み取ることができ、ツールチップとして表示できます。
コンポーネントが使用不可にされていると、ほとんどのブラウザでツールチップが表示されません。
visible。 型: boolean
描画される HTML ページでコンポーネントをユーザーに見えるようにするかどうかを指定します。このプロパティーはデフォルトで選択されています。このプロパティーを選択解除した場合、コンポーネントの HTML コードはページに描画されますが、スタイルの設定で非表示になっているので、コンポーネントをブラウザでは見ることができません。HTML コードが描画されているためコンポーネントはフォーム送信時に処理され、ブラウザでソース表示すると HTML コードを見ることができます。このほか、Web アプリケーションはクライアント側の JavaScript を使用して、コンポーネントを表示/非表示にできます。
たとえば特定のユーザーには見せない情報が含まれているなど、コンポーネントを完全に非表示にする必要がある場合は、「rendered」プロパティーを選択解除します。
アクセシビリティー
alt。 型: String
画像用の代替テキスト。HTML ページでグラフィック要素を説明し、スクリーンリーダーで読み取ることが可能で、ユーザーが Web ブラウザで画像の表示を無効にしたときに表示されるテキストです。HTML の <img> タグの alt 属性に相当します。
longdesc。 型: String
この画像の説明がある Web ページの URL。HTML では、このプロパティーは、生成される <img> タグの longdesc 属性になります。
JavaScript
onClick。 型: String
ユーザーがコンポーネントをクリックしたときに実行する JavaScript。
onDblClick。 型: String
ユーザーがコンポーネントをダブルクリックしたときに実行する JavaScript。
onMouseDown。 型: String
マウスカーソルがコンポーネント上にあり、ユーザーがマウスボタンを押し続けているときに実行する JavaScript。
onMouseMove。 型: String
ユーザーがコンポーネント上でマウスカーソルを動かしているときに実行する JavaScript。
onMouseOut。 型: String
ユーザーがコンポーネント上に置かれていたマウスカーソルをコンポーネントの外に動かしたときに実行する JavaScript。
onMouseOver。 型: String
ユーザーがコンポーネント上でマウスカーソルを動かしているときに実行する JavaScript。
onMouseUp。 型: String
マウスカーソルがコンポーネントにあり、そこでユーザーがマウスボタンを離したとき実行する JavaScript。
詳細
hspace。 型: int
画像の左右に挿入する空白をピクセル単位で指定します。デフォルト値は指定されていませんが、通常は 0 以外の小さい値です。
rendered。 型: boolean
選択した場合、ページが送信されるたびに画像が描画され、処理されます。選択しなかった場合、画像がページに表示されることはなく、非表示コンポーネントとしても描画されません。
vspace。 型: int
画像の上下に挿入する空白をピクセル単位で指定します。デフォルト値は指定されていませんが、通常は 0 以外の小さい値です。
関連項目
画像コンポーネント
コンポーネントの手順
コンポーネント関連の手順早見表
著作権と商標について