コマンド - ハイパーリンク

クリック可能なハイパーリンクをページに作成します。このハイパーリンクを使用して、別のページにナビゲートしたり、 クライアント・サイドまたはサーバー・サイドのアクションを実行するようにプログラムしたりできます。このコンポーネントを選択すると、ハイパーリンクと、別個の編集可能コンポーネントである関連の出力テキストが追加されます。

設計時のコンポーネント

コマンド - ハイパーリンク」コンポーネントをページにドラッグ・アンド・ドロップします:
「コマンド - ハイパーリンク」コンポーネント・ボタン

コマンド - ハイパーリンク」コンポーネントは、 ページでこのように表示されます:
設計時の「コマンド - ハイパーリンク」

実行時のコンポーネント

コマンド - ハイパーリンク」コンポーネントは、 実行時にページでこのように表示されます:
実行時の「コマンド - ハイパーリンク」

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

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

「コマンド - ハイパーリンク」コンポーネントのこれらの共通属性は、「プロパティー」ビューの「h:commandLink」 タブ、「パラメーター」タブ、および「アクセシビリティ (Accessibility)」タブに表示されます。属性の詳細なリストについては、『コマンド - ハイパーリンクの全属性』の表を参照してください。パラメーターおよびアクションを追加するその他の構成オプションは、「h:commandLink」タブおよび「h:commandLink」> 「パラメーター」 タブにあります。

構成オプション

説明

アクションに渡すパラメーターの追加

コンポーネントがどのパラメーターをアクションに渡すのかを指定します。

クリックしてこのリンクが実行するアクションをコード化

「クイック編集」ビューに切り替えて、実行するハイパーリンクのアクションをプログラムできるようにします。また、アクションおよび戻される結果に基づいて、規則を定義できます。

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

表 1. チェック・ボックス・グループの全属性

属性名

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

説明

accesskey

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

単一のキーボード・キーをアクセス・キーとして指定します。指定されたアクセス・キーを実行時に押すと、このコンポーネントにフォーカスが当てられます。

action

再表示しない

コンポーネントのクリック時に戻される値を指定します。この値はデフォルトのナビゲーション・ハンドラーに渡されます。ナビゲーション・ハンドラーは、アプリケーション構成ファイルに定義されている一連のナビゲーション規則にこの値を適合させます。

actionListener

再表示しない

アクションに応答するクラスの名前。これは、 ボタンやリンクなどのアクションを起こすことができるコンポーネントだけに関係しています。

binding

再表示しない

通常はバッキング・ファイルの中でこのコンポーネントを表す UIComponent。

charset

再表示しない

このハイパーリンクで指定されたリソースの文字エンコード。

coords

再表示しない

画面上のホット・スポットの位置および形状 (クライアント・サイド・イメージ・マップの中で使用)。

dir

再表示しない

実行時のコンポーネントの表示方向を指定します。指定できる値は次のいずれかです。
  • ltr - 左から右
  • rtl - 右から左

hreflang

再表示しない

このハイパーリンクで指定されたリソースの言語コード。

id

ID

名前をコンポーネントに割り当てます。JSP 内の固有名でなければなりません。

immediate

再表示しない

この値が true の場合は、ライフ・サイクルのレンダリング・フェーズに直接スキップしてください。

lang

再表示しない

コンポーネントの属性値およびテキスト内容の基本言語を指定します。 ISO 標準言語の省略形コード (たとえば、英語の場合は「en」、米国英語の場合は「en-US」、フランス語の場合は「fr」、ドイツ語の場合は「de」) を使用します。

rel

再表示しない

このハイパーリンクで指定されたアンカーと現行の文書との関係。この属性の値は、リンク・タイプのスペースで区切られたリストです。

rendered

再表示しない

true または false に設定できます。
  • false - コンポーネントは実行時にブラウザーへのレンダリングが行われません。
  • true - コンポーネントのレンダリングが行われます。

rev

再表示しない

このハイパーリンクで指定されたアンカーから現行の文書への逆方向リンク。 この属性の値は、リンク・タイプのスペースで区切られたリストです。

shape

再表示しない

リンクの形状を設定します。
  • rect
  • circle
  • poly

styleClass

スタイル: クラス

このエレメントのレンダリング時に適用される CSS スタイル・クラスのスペースで区切られたリスト。この値は、生成されたマークアップ上の「class」属性としてパススルーする必要があります。選択されたコンポーネントのクラス (スタイル・シートなど) を定義します。これは、手動で行うことも、ボタンをクリックして希望するクラスをウィンドウ内で選択して行うこともできます。

style

スタイル: プロパティー

コンポーネントの CSS スタイル情報 (たとえば、style="font-size : 8pt ; color : red") を指定します。選択されたコンポーネントのプロパティー (フォントや色など) を定義します。これは、手動で行うことも、ボタンをクリックして希望するプロパティーをウィンドウ内で選択して行うこともできます。

target

再表示しない

ハイパーリンクのクリック時にページをロードする必要があるフレームセット内のターゲット・フレームを割り当てます。
  • 新規ウィンドウ
  • 同じフレーム
  • 親フレーム
  • フルスクリーン

tabindex

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

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

title

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

実行時にツールチップとしてブラウザーに表示されるタイトル・テキストを指定します。

type

再表示しない

サブミット」または「リセット」のいずれかのボタン・タイプを指定します。このボタンを使用すると、関連するフォームの情報をサブミットまたはリセットすることができます。

value

再表示しない

実行時に表示されるコンポーネントの初期テキスト値を指定します。表示される情報が、指定された値の形式で、または動的値へのポインターの形式で組み込まれます。

関連概念
JavaServer Faces を使用したデータ・アクセス Web アプリケーションの作成
関連タスク
Faces アプリケーションの作成 - 概要
関連資料
Faces コンポーネントの参照
Faces コンポーネントの属性
コマンド - ボタン
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.