JSF 標準リンクアクションコンポーネントの「プロパティー」ウィンドウ
関連項目
ビジュアルデザイナーの編集中のページで JavaServer Faces のリンクアクションコンポーネントの外側の部分を選択するか、「ナビゲータ」ウィンドウでこの複合コンポーネントのリンクアクション
の部分を選択すると、リンクアクションプロパティーが「プロパティー」ウィンドウに表示されます。
- リンクアクションコンポーネントでは、リンクアクションコンポーネント
に出力テキストコンポーネント
が埋め込まれています。ビジュアルデザイナーでこのコンポーネントを選択すると、「ナビゲータ」ウィンドウにそのコンポーネントが表示され、操作するコンポーネント部分を選択できます。
この JavaServer Faces 標準コンポーネントには、次のプロパティーがあります。
「一般」
- id。
型: Text
ページ Bean および JSP ファイルでのリンクアクションコンポーネントの名前。
- target。
型: String
開くリンクがある現在のページのフレーム。
Appearance
- style。
型: String
コンポーネントに適用する階層式スタイルシートの規則 (CSS レベル 2)。このプロパティーは、プロジェクトの CSS ファイルの設定をオーバーライドします。例:
position: absolute; left: 288px; top: 312px
値を直接入力するか、省略符号ボタン (...) をクリックしてスタイルエディタを使用して入力します。
CSS2 スタイル属性の一覧は、次の Web ページを参照してください。
- styleClass。
型: String
コンポーネントの生成時に適用する CSS スタイルクラスの空白区切りのリスト。スタイルクラスは、プロジェクトのスタイルシートで定義されている必要があります。省略符号ボタン (...) を押すと、このプロパティーに追加できるすべてのスタイルが表示されます。プロジェクトの階層式スタイルシートに CSS のクラスや規則を追加する方法については、CSS エディタを参照してください。
- title。
型: String
スクリーンリーダーで読み取ることが可能で、ツールチップとして表示可能な、このリンクアクションに関する情報。
- コンポーネントが使用不可にされていると、ほとんどのブラウザでツールチップが表示されません。
イベント
ビジュアルデザイナーでコンポーネントを右クリックして、「イベントハンドラを編集」>「<イベント名>」選択することによってイベントのプロパティーを設定できます。
- action。ユーザーがリンクアクションをクリックしたときに呼び出すリンクアクションメソッドの名前を指定します。ページ Bean に存在しない、
CommandHyperlink1_action などのメソッド名が入力された場合、IDE は自動的にページ Bean にそのメソッド名を追加し、「action」プロパティーの値を更新して、そのメソッドを指し示すようにします。
ユーザーがリンクアクションをクリックしたときに別のページが表示されるようにするだけの場合、アクションメソッドは必要ありません。これを行う最も簡単な方法は、ページナビゲーションエディタを開き、そのページをクリックし、リンクアクションをドラッグして、リンクアクションによって開くページにドロップする方法です。詳細は、静的ページナビゲーションの設定を参照してください。
いくつかの条件に基づいて、開くページをリンクアクションが判定できるようにする場合は、アクションメソッドが必要です。一般に、このアクションメソッドはリンクアクションのクリックを処理し、ページのナビゲーションケース (case) 名を示す文字列 (次に表示するアプリケーション内のページ) を返します。一般に、こうしたメソッドを定義するには、ビジュアルデザイナーでコンポーネントを選択し、「ナビゲータ」ウィンドウでそのリンクアクションの部分を右クリックして、「イベントハンドラを編集」>「action」を選択します。このメソッドのデフォルト名は CommandHyperlink-id_action で、CommandHyperlink-id はリンクアクションの「id」プロパティーの値です。詳細は、動的ページナビゲーションの設定を参照してください。
JavaScript
- onblur。
型: String
コンポーネントがフォーカスを失ったときに実行する JavaScript。
- onclick。
型: String
ユーザーがコンポーネントをクリックしたときに実行する JavaScript。
- ondblclick。
型: String
ユーザーがコンポーネントをダブルクリックしたときに実行する JavaScript。
- onfocus。
型: String
コンポーネントがフォーカスを得たときに実行する JavaScript。
- onkeydown。
型: String
コンポーネントにフォーカスがあり、キーが押されたときに実行する JavaScript。
- onkeypress。
型: String
コンポーネントにフォーカスがあり、キーが押されて離されたときに実行する JavaScript。
- onkeyup。
型: String
コンポーネントにフォーカスがあり、キーが離されたときに実行する JavaScript。
- onmousedown。
型: String
マウスカーソルがコンポーネント上にあり、ユーザーがマウスボタンを押し続けているときに実行する JavaScript。
- onmousemove。
型: String
ユーザーがコンポーネント上でマウスカーソルを動かしているときに実行する JavaScript。
- onmouseout。
型: String
ユーザーがコンポーネント上に置かれていたマウスカーソルをコンポーネントの外に動かしたときに実行する JavaScript。
- onmouseover。
型: String
ユーザーがコンポーネント上でマウスカーソルを動かしているときに実行する JavaScript。
- onmouseup。
型: String
マウスカーソルがコンポーネントにあり、そこでユーザーがマウスボタンを離したとき実行する JavaScript。
詳細
- accesskey。
型: String
このリンクアクションをアクティブにするキーボードキーまたはキーボードショートカット。キーボードから入力できる任意の有効な文字を入力できます。HTML の <input> タグの accesskey 属性に相当します。
- action。
型: MethodBinding
上記の「イベント」の「action」プロパティーを参照してください。このプロパティーで、この値を設定します。このプロパティーは、「イベント」の「action」プロパティーが設定されるか、ビジュアルデザイナーでリンクアクションを右クリックして、「イベントハンドラを編集」>「action」を選択すると、自動的に設定されます。このプロパティーはまた、ページナビゲーションエディタを使用して、リンクアクションを別のページにリンクした場合にも自動的に設定されます。
- actionListener。
型: MethodBinding
ユーザーがコンポーネントをアクティブにした場合に通知される、アクションリスナーメソッドを表すメソッドバインド。値は #{Page1.action_method} といった有効な JSF メソッドバインド式である必要があり、この式では、戻り値の型が void である ActionEvent パラメータを受け取る public メソッド名を評価します。「actionListener」プロパティーには、直接 MethodBinding 式を入力できます。これはたとえば、ページ Bean にないメソッドを呼び出すような場合です。
- charset。
型: String
このハイパーリンクのリンク先ドキュメントまたはリソースの文字エンコーディング。HTML の <a> タグの charset 属性に相当します。エンコーディングの一覧は次の Web サイトにあります。
- coords。
型: String
クライアント側の画像マップに使用する、ページ上のホットスポットの位置と形状。HTML の <a> タグの coords 属性に相当します。値の個数と順序は、定義する「shape」プロパティーによって異なります。可能な組み合わせは次のとおりです。
- 矩形。 左上の角-x, 左上の角-y, 右下の角-x, 右下の角-y
- 円。 中心点の座標-x, 中心点の座標-y, 半径
- 多角形。 x1, y1, x2, y2, ..., xN, yN。最初と最後の x および y 座標ペアは同じ値で多角形を閉じる必要があります。
座標値はオブジェクトの左上角を基準にします。すべての値は長さです。すべての値を空白で区切ります。
- dir。
型: String
たとえばテキストは英語だが、ページの主言語がヘブライ語であるためにテキストの方向性が継承されない場合の方向性の指示。HTML の <input> タグの dir 属性に相当します。
値は次のいずれかです。
- hreflang。
型: String
このハイパーリンクのリンク先ドキュメントまたはリソースが使用する言語を表すコード。このプロパティーは、次に説明する言語コードと同じ値を取ります。
- immediate。
型: boolean
このプロパティーを選択すると、ユーザーがリンクアクションをアクティブにしたとき、妥当性検査やモデル値の更新などの前にページ Bean 内のコードが実行されます。基本的には、コードの実行はサーバーでただちに行われ、ページが返されます。
immediate アクションの最も一般的な例は、「取消し」ボタンです。「取消し」ボタンを immediate にして通常の妥当性検査や更新を飛ばすことができますが、アクションハンドラは引き続き必要なことをすべて行うことができます。一般には、アクションハンドラは前のページに戻ります。デザインによっては、アクションハンドラが「トランザクションが取り消されました」などの情報メッセージをキューに入れるものもあります。より多くのことを行うことも可能です。たとえば、ユーザーがフォームの途中で取り消した事実を記録することもできます。
- lang。
型: String
コンポーネント用に生成されたマークアップに使用する言語を表すコード。HTML の <input> タグの lang 属性に相当します。言語コードを選択するには、省略符号ボタン (...) をクリックしてプロパティーエディタを開きます。たとえば、以下のような言語コードです。
ar - アラビア語
de - ドイツ語en - 英語
es - スペイン語
fr - フランス語
ja - 日本語
プロパティーエディタで提供しているコードのほかに、ISO 規格の名前を使って別のコードを入力することもできます。たとえば、以下のような言語コードです。
en-US - 米語
ja-JP - 日本語
zh-guoyu - 標準中国語 (マンダリン語)
zh-Hans - 簡体字中国語
zh-Hant - 繁体字中国語
- rel。
型: String
リンクされるドキュメントとの関係を指定します。HTML の rel 属性と同じです。空白区切りで種類のリストを指定します。種類は次のどれかです。
- 代替。リンクされるドキュメントのほかのバージョンに置き換えます。lang 属性と共に使用すると、ドキュメントの翻訳版に置き換えることを意味します。
- 付録. ドキュメント集の付録
- ブックマーク。ドキュメントエントリポイントへのリンク。
- 章。ドキュメント集の章。
- 目次。目次。
- 著作権。現在のドキュメントの著作権。
- 用語集。現在のドキュメントの用語集。
- ヘルプ。ヘルプドキュメント。
- 索引。現在のドキュメントの索引。
- 次へ。一連のドキュメント内の次のドキュメント。
- 前へ。一連のドキュメント内の前のドキュメント。
- 項。ドキュメント集の項。
- 開始。ドキュメント集の最初のドキュメント。ドキュメント集の先頭。
- スタイルシート。外部スタイルシートの参照。リンクの種類の「代替」と組み合わせて、ユーザーが選択可能なスタイルシートを提供します。
- 節。ドキュメント集の節。
- rendered。
型: boolean
選択した場合、このあとのページ送信時にリンクアクションが描画され、処理されます。選択しなかった場合、リンクアクションがページに表示されることはなく、非表示コンポーネントとしても描画されません。リンクアクションを描画するタイミングを決定する変数に、このプロパティーをバインドできます。たとえば航空機の予約フォームで、頻繁に利用する顧客にはリンクアクションを表示し、一般の利用客には表示しないようにできます。このプロパティーをバインドするには、ビジュアルデザイナーでコンポーネントを右クリックし、「プロパティーのバインド」を選択し、「すべて」ラジオボタンを選択します。これで、すべてのプロパティーが表示され、「rendered」プロパティーをバインドできます。
- rev。
型: String
このハイパーリンクのリンク先のドキュメントからこのドキュメントに戻す逆方向の種類のリンク。HTML の rev 属性に相当し、空白区切りで種類のリストを指定します。種類のリストは上記の「rel」プロパティーを参照してください。
- shape。
型: String
クライアント側の画像マップに使用する、ページ上のホットスポットの形状。HTML の <a> タグの shape 属性に相当します。可能な値は次のとおりです。
- デフォルト。領域全体。
- 矩形。矩形領域。
- 円。円形領域。
- 多角形。多角形領域。
- tabindex。
型: String
ユーザーがタブでドキュメント内を移動した場合にリンクアクションがフォーカスを得るタイミングを決定するタブ順でリンクアクションの位置を指定します。値は 0 ~ 32767 の範囲の整数です。HTML の <input> タグの tabindex 属性に相当します。
- type。
型: String
このハイパーリンクのリンク先のリソースの内容の種類。HTML の type 属性に相当します。text/html、image/png、image/gif、video/mpeg、text/css、audio/basic などの MIME タイプのことです。
- 関連項目
- 標準リンクアクションコンポーネント
- コンポーネントの手順
- コンポーネント関連の手順早見表
著作権と商標について