「リンク」コンポーネントおよび「リンク - コマンド」コンポーネントを使用して、サイト・ジャンプとページ・ジャンプを Web プロジェクトに追加できます。
一般に、「リンク」コンポーネントは Web プロジェクトの外側にある Web ページにリンクする場合に使用し、「リンク - コマンド」コンポーネントは内部ページにリンクする場合に使用します。
「リンク - コマンド」コンポーネントは、リンクがアクティブになったときに、追加のアクションを使用可能にする場合にも使用できます。
ハイパーリンクは更新を実行して、ナビゲート先である Web プロジェクト内の次のページを識別できます。例えば、関連レコード・リスト内の単一行に適用するアクションに、「リンク - コマンド」コンポーネントを使用できます。
Faces JSP ページに「リンク - コマンド」コンポーネントを追加する方法は、次のとおりです。
- 「リンク - コマンド」コンポーネントを、パレットからページへ、またはページに既にある「出力」コンポーネントあるいは「イメージ」コンポーネントへドラッグする。
注: 「リンク」コンポーネントまたは「リンク - コマンド」コンポーネントを Faces JSP ページのブランク域にドロップすると、「出力」コンポーネントが「リンク」コンポーネントまたは「リンク - コマンド」コンポーネント内に自動的に追加されます。この出力テキストには、リンクのラベルが含まれます。
- ラベルを変更するには、「出力テキスト」コンポーネントを選択する。
「出力テキスト」コンポーネントの「プロパティー」ビューで、
「値」フィールドに新しいラベルを入力する。
これは実行時に表示されるリンク・テキストです。
- このリンク・アイコンが選択されていることを確認し、「クイック編集」ビューを使用して、
このリンクのアクションをコマンド・イベントとして作成する。
(『Web ページへのスクリプト・イベントの追加』を参照してください。)
- 次に、「リンク - コマンド」コンポーネントの「プロパティー」ビューで、「規則の追加」をクリックして、ナビゲーションを追加する。
「ナビゲーション規則の追加」ダイアログが開きます。
ナビゲーション規則により、発生内容 (例えば、エラーなど) に応じてユーザーを特定のページに誘導できます。
ここで、「クイック編集」ビューで実行するアクションを定義します。
ナビゲーション規則はアクションからの戻り値をベースにして、進むべきページを判別します
(例えば、戻り値が success であり、
failure でなければ、特定のページに進むことができます。)。.
ナビゲーション規則により、指定されたアクションに特定したり、あるいは任意のアクションを適用したりすることができます。
さらに、指定されたページへのみ、あるいはプロジェクトのすべてのページにこの規則を適用させることもできます。
- 追加の「リンク - コマンド」プロパティーを設定する。例えば、「リンク - コマンド」の「プロパティー」ビューの「パラメーター」タブで、任意のパラメーターを追加できます。
追加されたパラメーターは、アクションに渡されます。