ボタン - コマンド

このコンポーネントは、テキスト・ラベルまたはイメージのどちらかを含むプッシュボタンを作成します。 このボタンを使用して、フォームのサブミットまたはリセットを行うことができます。 さらに、サーバー・サイド・アクション またはクライアント・サイド・アクションを実行したり 別のページにナビゲートしたりするために、 プログラムすることも可能です。

設計時のコンポーネント

「ボタン - コマンド」コンポーネントを次のページにドラッグ・アンド・ドロップします。

「ボタン - コマンド」コンポーネント・ボタン

デザイン時のページ上の「ボタン - コマンド」コンポーネントは、 次のようになります。

デザイン時の「ボタン - コマンド」

実行時のコンポーネント

実行時のページ上の「ボタン - コマンド」コンポーネントは、次のようになります。

実行時の「ボタン - コマンド」

「プロパティー」ビューと「すべての属性」ビュー

コンポーネントの「プロパティー」ビューには、 コンポーネントに設定できる最も一般的な属性のセットが表示されます。 コンポーネントによっては、制御、アクション、 または他のコンポーネントの追加に関するオプションが 表示される場合もあります。 「プロパティー」ビューを開くには、 「ウィンドウ」 > 「ビューの表示」 > 「プロパティー」とクリックします。

「ボタン - コマンド」コンポーネントの 共通属性は、「プロパティー」ビューの 「hx:commandExButton」タブ、「表示オプション」タブ、 「パラメーター」タブ、 および「アクセシビリティー」タブに表示されます。 属性の完全なリストについては、「ボタン - コマンド」のすべての属性 の 表を参照してください。 パラメーターおよびアクションを追加する追加構成オプションが、 「hx:commandExButton」タブ および 「hx:commandExButton>パラメーター」タブにあります。

構成オプション

説明

アクションに渡されるパラメーターの追加

コンポーネントによってアクションに渡される パラメーターを指定します。

クリックすると、このボタンが実行するアクションをコード化します

「クイック編集」ビューに切り替えて、実行されるコマンド・ボタンの アクションをプログラムできるようにします。さらに、アクションおよび戻される結果を基にして、 規則を定義することもできます。

「すべての属性」ビューには、コンポーネントで設定できるすべての属性の表が表示されます。 この表には、「プロパティー」ビューからアクセスできる属性も含まれます。 「すべての属性」ビューに切り替えるには、 「プロパティー」ビューの右上隅にある「すべての属性」アイ コン「すべての属性」
アイコンをクリックします。

表 1. 「ボタン - コマンド」のすべての属性

属性名

「プロパティー」ビューでの表示

説明

accesskey

「アクセシビリティ」>「アクセス・キー」

アクセス・キーとして、単一のキーボード・キーを指定します。 実行時に指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます。実行時に Alt (前面) キーと 指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます (コンポーネントが ボタンの一種である場合は、そのコンポーネントが実行されます)。

action

非表示

コンポーネントをクリックしたときに戻される値を指定します。 この値は、デフォルトの NavigationHandler に渡され、 アプリケーション構成ファイル内で定義された ナビゲーション規則のセットと、マッチングされます。

actionListener

非表示

引数が ActionEvent で、 戻りの型が "void" であるメソッドを指す式。

alt

「アクセシビリティ」>「代替テキスト」

コンポーネントの代替テキストを指定します。 この代替テキストが表示されるのは、 要素が正常にレンダリングされない場合です。 例えば、ブラウザーがフォームをサポートしていない場合や、 ブラウザーがイメージを表示しないように 設定されている場合などです。

binding

非表示

コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。

confirm

プロンプト・テキスト

commandExButton を押したときに、 確認を要求するテキストが表示されるように指定します。 この属性の値が設定されていない場合は、 確認ダイアログは表示されません。

converter

非表示

値の変換後のデータ型を指定します。 JavaServer Faces の実装によって、 コンポーネント・データをレンダラーがサポートしない型に変換する際に使用できる、 コンバーターの実装セットが提供されます。

dimage

「タイプ」>「イメージ: 使用不可イメージ」

コンポーネントが使用不可のときに表示されるイメージを指定します。

dir

非表示

実行時にレンダリングされるときのコンポーネントの方向を指定します。 次のいずれかの値にできます。
  • ltr - 左から右
  • rtl - 右から左
方向を指定しない場合は、コンポーネントのエンコード方式に適している方向が使用されます。

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 に設定できます。
  • false - コンポーネントは、実行時にブラウザーにレンダリングされません。
  • true - コンポーネントがレンダリングされます。これはデフォルト値です。

size

非表示

コンポーネントの初期幅を指定します。 幅はピクセル単位で指定します。ただし、値が文字数を参照するテキスト入力コンポーネントの場合は除きます。

styleClass

スタイル: クラス

この要素がレンダリングされるときに適用される、 CSS スタイル・クラスのリスト (スペース区切り)。 この値は、生成されたマークアップの クラス属性として渡されなければなりません。 選択されたコンポーネントのクラス (例えば、スタイルシート) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なクラスを選択してください。

style

スタイル: プロパティー

コンポーネントに対して CSS スタイル情報を指定します (例えば、style="font-size : 8pt ; color : red")。 選択されたコンポーネントのプロパティー (例えば、フォントおよび色) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なプロパティーを選択してください。

tabindex

「アクセシビリティ」>「タブ順序インデックス」

JSP 内のタブ順序でコンポーネントの位置を指定します。 この値は、0 から 32767 までの数値でなければなりません。

title

「アクセシビリティ」>「タイトル」

実行時にツールチップとしてブラウザーに表示される、タイトル・テキストを指定します。 コンポーネントの代替テキストが指定されていない場合、 ブラウザーはこのテキストを代替テキストとして使用します。

type

種類

ボタンのタイプを、 「実行」「リセット」「プレーン (Plain)」の中から指定します。

value

「タイプ」>「テキスト: ボタン・ラベル」

コマンド・ボタン内で表示されるテキストを指定します。

関連概念
データ・テーブル・コンポーネント
関連タスク
Faces JSP ファイルへのハイパーリンクの追加
Faces JSP ページにおけるナビゲーション規則の使用
関連資料
リンク - コマンド
リンク

フィードバック