「ボタン - コマンド」コンポーネントを次のページにドラッグ・アンド・ドロップします。
デザイン時のページ上の「ボタン - コマンド」コンポーネントは、 次のようになります。
実行時のページ上の「ボタン - コマンド」コンポーネントは、次のようになります。
コンポーネントの「プロパティー」ビューには、 コンポーネントに設定できる最も一般的な属性のセットが表示されます。 コンポーネントによっては、制御、アクション、 または他のコンポーネントの追加に関するオプションが 表示される場合もあります。 「プロパティー」ビューを開くには、
とクリックします。「ボタン - コマンド」コンポーネントの 共通属性は、「プロパティー」ビューの 「hx:commandExButton」タブ、「表示オプション」タブ、 「パラメーター」タブ、 および「アクセシビリティー」タブに表示されます。 属性の完全なリストについては、「ボタン - コマンド」のすべての属性 の 表を参照してください。 パラメーターおよびアクションを追加する追加構成オプションが、 「hx:commandExButton」タブ および 「hx:commandExButton>パラメーター」タブにあります。
構成オプション |
説明 |
---|---|
アクションに渡されるパラメーターの追加 |
コンポーネントによってアクションに渡される パラメーターを指定します。 |
クリックすると、このボタンが実行するアクションをコード化します |
「クイック編集」ビューに切り替えて、実行されるコマンド・ボタンの アクションをプログラムできるようにします。さらに、アクションおよび戻される結果を基にして、 規則を定義することもできます。 |
「すべての属性」ビューには、コンポーネントで設定できるすべての属性の表が表示されます。
この表には、「プロパティー」ビューからアクセスできる属性も含まれます。
「すべての属性」ビューに切り替えるには、
「プロパティー」ビューの右上隅にある「すべての属性」アイ
コンをクリックします。
属性名 |
「プロパティー」ビューでの表示 |
説明 |
---|---|---|
accesskey |
「アクセシビリティ」>「アクセス・キー」 |
アクセス・キーとして、単一のキーボード・キーを指定します。 実行時に指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます。実行時に Alt (前面) キーと 指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます (コンポーネントが ボタンの一種である場合は、そのコンポーネントが実行されます)。 |
action |
非表示 |
コンポーネントをクリックしたときに戻される値を指定します。 この値は、デフォルトの NavigationHandler に渡され、 アプリケーション構成ファイル内で定義された ナビゲーション規則のセットと、マッチングされます。 |
actionListener |
非表示 |
引数が ActionEvent で、 戻りの型が "void" であるメソッドを指す式。 |
alt |
「アクセシビリティ」>「代替テキスト」 |
コンポーネントの代替テキストを指定します。 この代替テキストが表示されるのは、 要素が正常にレンダリングされない場合です。 例えば、ブラウザーがフォームをサポートしていない場合や、 ブラウザーがイメージを表示しないように 設定されている場合などです。 |
binding |
非表示 |
コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。 |
confirm |
プロンプト・テキスト |
commandExButton を押したときに、 確認を要求するテキストが表示されるように指定します。 この属性の値が設定されていない場合は、 確認ダイアログは表示されません。 |
converter |
非表示 |
値の変換後のデータ型を指定します。 JavaServer Faces の実装によって、 コンポーネント・データをレンダラーがサポートしない型に変換する際に使用できる、 コンバーターの実装セットが提供されます。 |
dimage |
「タイプ」>「イメージ: 使用不可イメージ」 |
コンポーネントが使用不可のときに表示されるイメージを指定します。 |
dir |
非表示 |
実行時にレンダリングされるときのコンポーネントの方向を指定します。
次のいずれかの値にできます。
|
disabled |
非表示 |
disabled が true に設定されると、 コンポーネントは実行時に表示されますが、機能しません。 ブランクのままにした場合のデフォルト値は false です。 |
himage |
「タイプ」>「イメージ: マウス・イメージ」 |
ユーザーのマウス・ポインターがコンポーネント上を通過するときに、 表示されるイメージを指定します。 |
id |
ID |
コンポーネントに名前を割り当てます。JSP 内で固有の名前にする必要があります。 |
image |
「タイプ」>「イメージ: 標準イメージ」 |
コンポーネント内で表示されるイメージの URL/URI を指定します。 |
immediate |
非表示 |
true にすると、ライフ・サイクルのレンダリング・フェーズまでスキップします。 |
lang |
非表示 |
コンポーネントの値およびテキスト・コンテンツの言語。
省略されている場合、言語は含まれているタグ (特にビュー) から継承されます。これは、ISO 規格言語省略コードで指定します。例えば、英語は「en」、米国英語は「en-US」、
フランス語は「fr」、ドイツ語は「de」を使用します。
注: これは、コンポーネント内のテキストを変換するのではなく、検索、ソート、照合などの操作が正しく実行されるようにコンポーネントの言語を識別します。
|
pimage |
「タイプ」>「イメージ: 押し下げイメージ」 |
ユーザーがコンポーネントをクリックしたときに、表示されるイメージを指定します。 |
readonly |
非表示 |
コンポーネントの値を、初期値から変更できなくさせるように指定します。 |
rendered |
非表示 |
true または false に設定できます。
|
size |
非表示 |
コンポーネントの初期幅を指定します。 幅はピクセル単位で指定します。ただし、値が文字数を参照するテキスト入力コンポーネントの場合は除きます。 |
styleClass |
スタイル: クラス |
この要素がレンダリングされるときに適用される、 CSS スタイル・クラスのリスト (スペース区切り)。 この値は、生成されたマークアップの クラス属性として渡されなければなりません。 選択されたコンポーネントのクラス (例えば、スタイルシート) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なクラスを選択してください。 |
style |
スタイル: プロパティー |
コンポーネントに対して CSS スタイル情報を指定します (例えば、style="font-size : 8pt ; color : red")。 選択されたコンポーネントのプロパティー (例えば、フォントおよび色) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なプロパティーを選択してください。 |
tabindex |
「アクセシビリティ」>「タブ順序インデックス」 |
JSP 内のタブ順序でコンポーネントの位置を指定します。 この値は、0 から 32767 までの数値でなければなりません。 |
title |
「アクセシビリティ」>「タイトル」 |
実行時にツールチップとしてブラウザーに表示される、タイトル・テキストを指定します。 コンポーネントの代替テキストが指定されていない場合、 ブラウザーはこのテキストを代替テキストとして使用します。 |
type |
種類 |
ボタンのタイプを、 「実行」、 「リセット」、 「プレーン (Plain)」の中から指定します。 |
value |
「タイプ」>「テキスト: ボタン・ラベル」 |
コマンド・ボタン内で表示されるテキストを指定します。 |