この章では、JSFページのダイアログ、メニュー、ウィンドウなど、セカンダリ・ウィンドウでポップアップを作成および使用する方法について説明します。使用できるオプションとしては、宣言的またはプログラムによるポップアップの起動、コンテキストに依存した情報の表示、入力フィールドのリセット、インライン・ポップアップの自動取消の制御などがあります。
この章の内容は次のとおりです。
popup
コンポーネントを他のいくつかのADF Facesコンポーネントとともに使用して、情報を表示またはエンド・ユーザーからの入力を要求する様々なダイアログ、メニューおよびウィンドウを作成できます。これらのコンポーネントを使用して、エンド・ユーザーがセカンダリ・ウィンドウの情報の表示と非表示、追加データの入力または機能の呼出しを行うことのできる機能を構成できます。これらのコンポーネントによって提供される機能により、プライマリ・インタフェースでレンダリングされるコンテンツの補足であるコンテンツまたは機能をレンダリングでき、その結果、整然としたユーザー・フレンドリなインタフェースを開発できます。
popup
コンポーネントは非表示のレイアウト・コントロールであり、インライン(つまり、同じページに属する)ダイアログ、ウィンドウおよびメニューを表示するために他のコンポーネントと一緒に使用されます。popup
コンポーネントはプライマリ・インタフェース内から呼び出され、アプリケーションは、ポップアップ・ブロッカの干渉を受けずに、プライマリ・インタフェースのコンテンツなど、popup
コンポーネントにレンダリングするコンテンツを管理します。popup
コンポーネントにレンダリングするコンテンツのタイプはHTMLにすることをお薦めします。FlashやPDFファイルなどの他のタイプのコンテンツは、popup
コンポーネントに適切にレンダリングされないことがあります。
図16-1に、popup
コンポーネントがADF Facesコンポーネントと連携してセカンダリ・ウィンドウをレンダリングする例を示します。
親ページとは別に表示されるプロセスのページの作成をサポートするために、ADF Facesにはダイアログ・フレームワークが用意されています。このフレームワークでは、独自の制御フローを持つ複数のダイアログ・ページがサポートされています。たとえば、ユーザーがWebサイトで購入を選択した後の支払い手続き(チェックアウト)中に、支払いを完了する前に新しいクレジット・カードへの申込みを決定したとします。外部ブラウザ・ウィンドウで、ダイアログ・フレームワークを使用してクレジット・カードのトランザクションが開始されます。クレジット・カードのトランザクションが終了しても、元のページのチェックアウト・トランザクションは終了しません。
このダイアログ・フレームワークは、親ページの一部としてインラインで使用することもできます。これが役立つのは、ページ独自の制御フローが必要であるけれども、外部ウィンドウがポップアップ・ブロッカでブロックされることを防ぎたい場合です。
アプリケーションで完全なFusionテクノロジ・スタックを使用する場合は、このダイアログ・フレームワークがADFタスク・フローで使用するためにADFコントローラと統合されていることに注意してください。詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』のモーダル・ダイアログでのバインド・タスク・フローの実行に関する項を参照してください。
アプリケーションのweb.xml
ファイルでLAST_WINDOW_SESSION_TIMEOUT
という名前のコンテキスト・パラメータを使用して、アプリケーションでウィンドウが1つのみ開いている場合にセッション・タイムアウトが発生するまでの最大非アクティブ期間を指定できます。コンテキスト・パラメータに対して指定する最大非アクティブ期間は、セッション・タイムアウトに対して指定する値よりも小さい必要があります。この機能を有効にし、セッションにウィンドウが1つのみ開いている場合、セッション・タイムアウトはこのコンテキスト・パラメータに対して指定した値に設定されます。例16-1に、web.xml
ファイルのLAST_WINDOW_SESSION_TIMEOUT
コンテキスト・パラメータの値を1800
秒に設定する方法を示します。
例16-1 アプリケーションの最後のウィンドウのセッション・タイムアウトの指定
<!-- Sets the session timeout to 1800 seconds when there is only one window open in the session and 1800 seconds is smaller then the original session timeout. This gives your application the option to end the session when an end user closes the last window. Specify a value in seconds. A negative value disables this feature. The default value is -1. --> <context-param> <param-name>LAST_WINDOW_SESSION_TIMEOUT</param-name> <param-value>1800</param-value> </context-param>
アプリケーションのweb.xml
ファイルの構成の詳細は、付録A「web.xmlでの構成」を参照してください。
dialog
コンポーネントをpopup
コンポーネントに子として配置し、実行時にポップアップにダイアログをレンダリングできます。dialog
コンポーネントは、popup
コンポーネントの唯一の直接の子コンポーネントである必要があります。実行時に、エンド・ユーザーは情報(検索基準など)を表示または入力でき、dialog
コンポーネントのデフォルトのボタンを使用できます。このボタンがクリックされると、dialogEvent
が呼び出されます。図16-2に、エンド・ユーザーが「閉じる」ボタンをクリックすることでダイアログを閉じる例を示します。
ポップアップ内でコンポーネントを使用して、別のコンポーネントに関連するコンテキスト情報を表示することもできます。そのように構成されている場合は、関連コンポーネントが小さな四角形を表示します。マウスが置かれると、アイコンが拡大し、ノート・アイコンも表示されます(図16-3を参照)。
ユーザーがノート・アイコンをクリックすると、関連付けられたポップアップにそのコンテンツが表示されます。
popup
コンポーネントを使用してダイアログ、メニューおよびウィンドウを作成する前に、他のADF Faces機能を理解することが役立つ場合があります。また、ページにpopup
コンポーネント(または関連コンポーネント)を追加した後で、アクセシビリティやローカライズなどの機能を追加することが必要になる場合があります。これらのコンポーネントで使用できる他の機能へのリンクを次に示します。
テキストでのパラメータの使用: コンポーネントに表示されるテキストに、実行時に解決されるパラメータを含める場合は、ADF Faces EL書式タグを使用できます。詳細は、3.5.2項「EL書式タグの使用方法」を参照してください。
イベント: dialog
コンポーネントは、ADF Faces button
コンポーネントをレンダリングします。button
コンポーネントをshowPopupBehavior
タグとともに使用してポップアップを起動することもできます。button
コンポーネントをshowPopupBehavior
タグとともに使用すると、アクティブ化されたときにActionEvent
イベントが配信されます。サーバーおよびクライアント上でのイベントの処理方法の詳細は、第6章「イベントの処理」を参照してください。
メッセージ: ポップアップ・ダイアログとセカンダリ・ウィンドウは、ユーザーに様々なレベルのヘルプ情報を提供するためによく使用されます。ユーザーへのメッセージの表示方法の詳細は、第19章「ヒント、メッセージおよびヘルプの表示」を参照してください。
ローカライズ: 作成するポップアップ・ダイアログ、メニューおよびウィンドウのラベルのテキストを直接入力するかわりに、プロパティ・ファイルを使用できます。これらのファイルにより、テキスト文字列の翻訳を管理できます。詳細は、第32章「ページの国際化およびローカライズ」を参照してください。
スキン: スキンを変更することで、ポップアップ・ダイアログ、メニューおよびウィンドウの作成に使用するコンポーネントのルック・アンド・フィールを変更できます。詳細は、第31章「スタイルおよびスキンを使用した外観のカスタマイズ」を参照してください。
アクセシビリティ: ポップアップ・ダイアログ、メニューおよびウィンドウをアクセス可能にできます。詳細は、第33章「アクセス可能なADF Facesページの開発」を参照してください。
ダイアログ・フレームワーク: アプリケーションで完全なFusionテクノロジ・スタックを使用する場合は、ダイアログ・フレームワークがADFタスク・フローで使用するためにADFコントローラと統合されていることに注意してください。詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』の「アプリケーションでのダイアログの使用」の章を参照してください。
タッチ装置: ADF Facesコンポーネントはタッチ装置によって異なる動作および表示を行うことがあります。詳細は、付録D「ADF Facesを使用したタッチ装置のWebアプリケーションの作成」を参照してください。
ドラッグ・アンド・ドロップ: ユーザーがコンポーネントをページの別の領域にドラッグ・アンド・ドロップできるように、コンポーネントを構成できます。詳細は、第35章「ドラッグ・アンド・ドロップ機能の追加」を参照してください。
dialog
、panelWindow
、menu
およびnoteWindow
コンポーネントは、すべてpopup
コンポーネントの内部で使用して、表16-1に示すようにインライン・ポップアップを表示できます。popup
コンポーネントの子コンポーネントが存在しない場合は、非常に単純なインライン・ポップアップが表示されます。
表16-1 popupコンポーネントで使用されるコンポーネント
コンポーネント | 実行時の表示 |
---|---|
|
子をダイアログ内に表示し、 |
|
ダイアログに似たウィンドウに子を表示しますが、イベントはサポートしません。詳細は、16.2.2項「パネル・ウィンドウの作成方法」を参照してください。 |
|
関連コンポーネントのポップアップ・メニューを表示します。詳細は、16.2.3項「ポップアップ・メニューの作成方法」を参照してください。 |
|
特定のUIコンポーネントに関連付けられた読取り専用の情報を表示します。ノート・ウィンドウはヘルプやメッセージの表示に使用され、通常はマウスを置いたり、フォーカスをしたときに表示されます。詳細は、16.2.4項「ノート・ウィンドウの作成方法」を参照してください。 |
|
コンテンツをインラインで表示します。 |
dialog
コンポーネントとpanelWindow
コンポーネントはいずれも定義ヘルプがサポートされていますが、ヘルプ・アイコン(疑問符が表示された青い丸)の上にカーソルを移動するとコンテンツが表示されます。dialog
およびpanelWindow
コンポーネントでは説明ヘルプはサポートされません。詳細は、第19章「ヒント、メッセージおよびヘルプの表示」を参照してください。
一般的には、button
コンポーネントをshowPopupBehavior
タグとともに使用してポップアップを起動します。showPopupBehavior
タグを、起動する必要のあるコンポーネントに関連付けます。このタグは、(必要に応じて)ポップアップの位置も制御します。
button
コンポーネントのアクション・イベントとともに使用することに加えて、showPopupBehavior
タグは他のイベント(showDetail
イベントやselection
イベントなど)とともに使用することもできます。詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。
showPopupBehavior
タグをアクション・コンポーネントとともに使用するかわりに、バッキングBeanメソッドを作成してポップアップを起動、取消または非表示にできます。作成するバッキングBeanメソッドは、アクション・コンポーネントによって返されるactionEvent
を引数として受け取ります。この代替方法の詳細は、16.4項「ポップアップのプログラムによる呼出し」を参照してください。
デフォルトで、ポップアップのコンテンツは、ポップアップが表示されるまでサーバーから送信されません。このため、開かれたときにポップアップが表示されるスピードと、親ページがレンダリングされるスピードが入れ替わります。ポップアップがロードされると、すぐに表示できるよう、コンテンツはクライアントにおいてデフォルトでキャッシュされます。
popup
コンポーネントのcontentDelivery
属性を次のいずれかのオプションに設定することで、コンテンツの配信戦略を変更できます。
lazy
- 前述のデフォルトの戦略。コンテンツは、ポップアップが一度表示されるまでロードされず、ロードされるとキャッシュされます。
immediate
- コンテンツはすぐにページにロードされるため、コンテンツを可能なかぎり迅速に表示できます。この方法は、ページが使用されるたびにすべてのユーザーが必ず使用するポップアップに使用します。
lazyUncached
- コンテンツはポップアップが表示されるまでロードされず、ポップアップを表示するたびにコンテンツが再ロードされます。この方法は、失効するか期限切れになる可能性があるデータをポップアップに表示する場合に使用します。
popup
コンポーネントのcontentDelivery
属性をlazy
に設定することを選択した場合、別のpopup
コンポーネント属性(childCreation
)をdeferred
に設定することで、popup
コンポーネントとそれをホストするページのパフォーマンスをさらに最適化できます。これにより、アプリケーションがコンテンツを配信するまでpopup
コンポーネントの子コンポーネントの作成が遅延されます。childCreation
属性のデフォルト値はimmediate
です。
ダイアログの終了時にイベントを起動する必要がある場合は、ダイアログを作成します。dialog
コンポーネントをpopup
コンポーネントに子として追加した後、他のコンポーネントを追加してデータを表示および収集できます。
デフォルトでは、dialog
コンポーネントは次のボタンの組合せを持つことができます。
「取消」
「OK」
「OK」および「取消」
「はい」および「いいえ」
「はい」、「いいえ」および「取消」
「なし」
これらのボタンは、クリックされるとdialogEvent
を起動します。buttonBar
ファセットを使用して、ダイアログに他のボタンを追加できます。追加するボタンはdialogEvent
を起動しません。かわりに、標準のactionEvent
を起動します。actionEvent
がダイアログ内のコンポーネントに対してのみ起動されるようにするために、追加するボタンのpartialSubmit
属性をtrue
に設定してください。ただし、af:popup
コンポーネントのautoCancel
プロパティの値をdisabled
に設定した場合は、ボタンを追加し、そのpartialSubmit
属性をfalse
に設定できます。この後者のオプション(partialSubmit
をfalse
に設定)を選択すると、アプリケーションはpopup
コンポーネントの可視性(また、拡張によりdialog
コンポーネント)をリストアする前にページを再ロードしてページのコンポーネントを再初期化するため、エンド・ユーザーの待機時間が長くなります。af:popup
コンポーネントのautoCancel
プロパティの値がenabled
(デフォルト値)に設定されている場合は、ボタンのpartialSubmit
属性をtrue
に設定する必要があります。af:popup
コンポーネントのautoCancel
プロパティの使用の詳細は、16.6項「インライン・ポップアップの自動取消の制御」を参照してください。
始める前に:
dialog
コンポーネントの属性およびその他のコンポーネントがインライン・ダイアログの機能に与える影響を理解することが役立つ場合があります。詳細は、16.2項「ポップアップの宣言的な作成」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
インライン・ダイアログを作成する手順:
「コンポーネント」ウィンドウの「レイアウト」パネルの「セカンダリ・ウィンドウ」グループから、「ポップアップ」をドラッグしてページにドロップします。
ヒント 位置はpopup の呼出しに使用されるコンポーネントによって決定されるため、popup コンポーネントがページに表示されるかどうかは関係ありません。ただし、popup コンポーネントはform コンポーネント内にある必要があります。 |
「プロパティ」ウィンドウの「共通」セクションを開いて、次の属性を設定します。
ContentDelivery: ポップアップのコンポーネントにコンテンツが配信される方法を選択します。
ヒント ダイアログの入力コンポーネントの値は、ユーザーがダイアログの「取消」ボタンをクリックしたときにリセットされません。ユーザーが2回目にダイアログを開いた場合、これらの値が依然として表示されます。この値をサーバーの現在の値に合せるには、contentDelivery 属性をlazyUncached に設定します。 |
Animate: ポップアップ・ダイアログのアニメーションを構成します。詳細は、16.2.7項「アニメーションおよびポップアップに関する必知事項」を参照してください。
LauncherVar: 起動コンポーネントの参照に使用する変数を入力します。この変数は、popupまたはその子コンポーネントでのイベント配信時にのみ、またEventContextがlauncher
に設定されている場合にのみアクセス可能です。
EventContext: ポップアップが複数のオブジェクトによって共有されている場合、たとえばポップアップ内のダイアログに表で選択された行に関する情報が表示される場合は、launcher
に設定します。この属性をlauncher
に設定すると、イベント・リスナーがコールされる前にクリックされた行が現在の行になり、その行のデータのみ返されます。詳細は、16.2.5項「実行時に行われる処理: popupコンポーネントのイベント」を参照してください。
必要に応じて、「プロパティ」ウィンドウで次の属性を設定します。
AutoCancel: インライン・ポップアップの自動取消を防ぐにはdisabledを選択します。詳細は、16.6項「インライン・ポップアップの自動取消の制御」を参照してください。
ChildCreation: deferredを選択すると、popup
コンポーネントの子コンポーネントの作成はアプリケーションのコンテンツが配信されるまで延期されます。childCreation
属性のデフォルト値はimmediate
です。詳細は、16.2項「ポップアップの宣言的な作成」を参照してください。
ResetEditableValues: エンド・ユーザーがダイアログを取り消す場合にエンド・ユーザーが入力した編集可能な値をnullにリセットするには、whenCanceled
を選択します。
または、resetListener
コンポーネントを使用できます。resetListener
コンポーネントの使用の詳細は、16.7項「ポップアップの入力フィールドのリセット」を参照してください。
「コンポーネント」ウィンドウから、「ダイアログ」をpopup
コンポーネントに直接の子としてドラッグ・アンド・ドロップします。
「プロパティ」ウィンドウの「共通」セクションを開いて、次の属性を設定します。
Type: ダイアログに表示する組込みの部分送信ボタンを選択します。
たとえば、type
属性をyesNoCancel
に設定した場合、ダイアログには「はい」、「いいえ」、「取消」のボタンが表示されます。これらのいずれかのボタンがクリックされると、ダイアログが閉じ、関連付けられた結果(ok
、yes
、no
またはcancel
)がイベントで配信されます。ok
、yes
およびno
の結果はdialogEvent
で配信されます。cancelの結果はPopupCanceled
イベントで送信されます。ロジックの決定に結果を使用して、適切なリスナー・プロパティを使用し、イベントを処理するメソッドにバインドできます。
ヒント エラーまたはそれより高い重大度のADF Facesメッセージがある場合、ダイアログは閉じません。 |
Title: ダイアログ・ウィンドウにタイトルとして表示するテキストを入力します。
CloseIconVisible: 「閉じる」アイコンをダイアログに表示するかどうかを選択します。
Modal: ダイアログをモーダルにするかどうかを選択します。モーダル・ダイアログでは、ユーザーはダイアログが閉じられるまでメイン・ページに戻ることができません。
Resize: ユーザーがダイアログのサイズを変更できるようにするかどうかを選択します。デフォルトはoff
です。
StretchChildren: 子コンポーネントをダイアログに合せて拡大するかどうかを選択します。first
に設定されている場合、ダイアログは単一の子コンポーネントを拡大します。ただし、拡大できる子コンポーネントであることが必要です。詳細は、9.2.1項「ジオメトリ管理およびコンポーネントの拡大」を参照してください。
注意: Resizeをon に設定するかStretchChildrenをfirst に設定した場合は、ContentWidthおよびContentHeightも設定する必要があります(手順8を参照)。それ以外の場合、サイズはデフォルトで250x250ピクセルになります。 |
「外観」セクションを開き、テキスト属性を設定します。
ボタン・テキストとアクセス・キーを別々に指定するかわりに、2つを結合して、アクセス・キーがボタン・テキストの一部になるようにできます。アクセス・キーとして使用する文字の前にアンパサンド(&)を付けます。
たとえば、肯定ボタンのテキストを「OK」にし、「OK」の「O」をアクセス・キーにする場合は、「&OK
」と入力します。
「動作」セクションを開き、必要に応じてDialogListener属性の値を入力します。値は、イベントを処理するダイアログ・リスナー・メソッドへのEL式メソッド参照である必要があります。
たとえば、項目の削除を確認するダイアログを作成するとします。例16-2に示すdeleteItem
メソッドのようなメソッドをマネージドBeanに作成できます。このメソッドは、イベントからの結果にアクセスします。結果がyes
以外の場合は、ダイアログが閉じられます。結果がyes
(ユーザーが項目を閉じることを意味します)の場合、メソッドは選択された項目を取得し、削除します。
例16-2 項目を削除するdialogEventのハンドラ
public void deleteItem(DialogEvent dialogEvent) { if (dialogEvent.getOutcome() != DialogEvent.Outcome.yes) { return; } // Ask for selected item from FileExplorerBean FileItem selectedFileItem = _feBean.getLastSelectedFileItem(); if (selectedFileItem == null) { return; } else { // Check if we are deleting a folder if (selectedFileItem.isDirectory()) { _feBean.setSelectedDirectory(null); } } this.deleteSelectedFileItem(selectedFileItem); }
例16-3に、dialogListener
属性がdeleteItem
メソッドにバインドされる方法を示します。
例16-3 メソッドにバインドされているdialogListener属性
<af:dialog title="#{explorerBundle['deletepopup.popuptitle']}"
type="yesNo"
dialogListener="#{explorer.headerManager.deleteItem}"
id="d1">
dialogEvent
は、結果がok
、yes
またはno
の場合にのみサーバーに伝播されます。必要に応じてこれをブロックできます。詳細は、6.3.5項「イベントがサーバーに伝播されないようにする方法」を参照してください。
ユーザーが「取消」ボタン(または「閉じる」アイコン)をクリックした場合、結果はcancel
で、popupCancel
クライアント・イベントがpopup
コンポーネントで発生します。popup
コンポーネントにレンダリングされた入力コンポーネントに入力された値は、サーバーに送信されません。popup
コンポーネントがレンダリングした後で値が変更された編集可能コンポーネントは、変更された値をサーバーに送信しません。popupCancel
イベントがサーバーに配信されます。
ダイアログのサイズを固定する場合、またはresizeがon
に設定済かstretchChildrenがfirst
に設定済の場合は、「外観」セクションを開いて次の属性を設定します。
ContentHeight: 目的の高さをピクセル単位で入力します。
ContentWidth: 目的の幅をピクセル単位で入力します。
ヒント (resize 属性がon に設定されている場合)ユーザーは実行時にこれらの属性の値を変更できますが、アプリケーションが変更の永続性を使用するように構成されていないかぎり、ユーザーがページを終了すると値は保持されません。変更の永続性の有効化および使用方法の詳細は、第34章「JSFページでのユーザー・カスタマイズの許可」を参照してください。 |
注意: アクション・コンポーネントをshowPopupBehavior タグなしで使用してダイアログを起動する場合に、そのアクション・コンポーネントのwindowHeight 属性およびwindowWidth 属性の値が指定されている場合は、アクション・コンポーネントでの値がcontentHeight およびcontentWidth の値よりも優先されます。ダイアログ・フレームワークでは、アクション・コンポーネントを使用してダイアログを起動するときにshowPopupBehavior タグを指定しないことも許可されます。詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』のモーダル・ダイアログでのバインド・タスク・フローの実行に関する項を参照してください。showPopupBehavior タグの詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。 |
必要に応じて、button
コンポーネントをbuttonBar
ファセットに追加します。追加したbutton
コンポーネントによって起動されるのは、標準のactionEvent
であり、dialogEvent
ではありません。actionEvent
がダイアログ内のコンポーネントに対してのみ起動されるようにするために、button
コンポーネントのpartialSubmit
属性をtrue
に設定してください。button
コンポーネントのpartialSubmit
属性をfalse
に設定できるのは、af:popup
コンポーネントのautoCancel
プロパティがdisabled
に設定されている場合です。af:popup
コンポーネントのautoCancel
プロパティとbutton
コンポーネントのpartialSubmit
プロパティの値によって、button
コンポーネントがクリックされたときにどのようにダイアログを閉じて再ロードするかが決まります。詳細は、16.6項「インライン・ポップアップの自動取消の制御」を参照してください。
ヒント ファセットがビジュアル・エディタに表示されていない場合は、「構造」ウィンドウでdialog コンポーネントを右クリックして「ファセット - ダイアログ」→「ButtonBar」を選択します。ページで使用されているファセットは、ファセット名の前にチェックマークが表示されます。 |
デフォルトでは、追加したbutton
コンポーネントはクリックされてもダイアログが閉じることはありません。button
コンポーネントのactionListener
を、ダイアログの終了およびその他の必要な処理を管理するハンドラにバインドする必要があります。これを行う方法の例は、タグのドキュメントを参照してください。
ダイアログのデータを表示または収集するコンポーネントを挿入します。panelGroupLayout
などのレイアウト・コンポーネントを使用してコンポーネントを含めます。
ヒント 通常は、ダイアログの「取消」ボタンまたは「閉じる」アイコンをクリックすると、inputText コンポーネントに入力されたデータは送信されません。ただし、ダイアログのinputText コンポーネントでautoSubmit 属性をtrue に設定すると、この設定が送信の原因となるためダイアログの取消動作がオーバーライドされます。 |
親ページにロジックを追加して、ポップアップとダイアログを呼び出します。詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。
panelWindow
コンポーネントはdialog
コンポーネントに似ていますが、ボタンの構成やファセットへのボタンの追加はできません。panelWindow
のデータを処理するロジックを呼び出す必要がある場合は、popup
コンポーネントのcancel
イベントのリスナーを作成する必要があります。
panelWindow
コンポーネントを含むpopup
コンポーネントは、form
コンポーネントに含まれている必要があります。
ヒント Fusionテクノロジ・スタックを使用するアプリケーションでpanelWindow をインライン・ポップアップとして使用する場合に、ダイアログの外観をエミュレートするには、panelStretchLayout コンポーネントの中央ファセットにpanelWindow コンポーネントを配置し、button ボタンをbottom ファセットに配置します。 |
始める前に:
panelWindow
コンポーネントの属性がインライン・ウィンドウの機能に与える影響を理解することが役立つ場合があります。詳細は、16.2項「ポップアップの宣言的な作成」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
インライン・ウィンドウを作成する手順:
「コンポーネント」ウィンドウの「レイアウト」パネルの「セカンダリ・ウィンドウ」グループから、「ポップアップ」をドラッグしてページにドロップします。
ヒント 位置はpopupの呼出しに使用されるコンポーネントによって決定されるため、popup コンポーネントがページに表示されるかどうかは関係ありません。ただし、popup コンポーネントはform コンポーネント内にある必要があります。 |
「プロパティ」ウィンドウの「共通」セクションを開いて、次の属性を設定します。
ContentDelivery: ポップアップのコンポーネントにコンテンツが配信される方法を選択します。
ヒント 入力コンポーネントの値は、ユーザーがpanelWindow コンポーネントを閉じたときにリセットされません。ユーザーが2回目にウィンドウを開いた場合、これらの値が依然として表示されます。この値をサーバーの現在の値に合せるには、contentDelivery 属性をlazyUncached に設定します。 |
Animate: ポップアップ・ウィンドウのアニメーションを構成します。詳細は、16.2.7項「アニメーションおよびポップアップに関する必知事項」を参照してください。
LauncherVar: 変数の名前(source
など)を入力します。表のvar
属性と同様に、この変数はリクエスト・スコープの参照を、showPopupBehavior
タグを含むコンポーネントに格納するために使用されます。変数は、popup
またはその子コンポーネントでのイベント配信時にのみ、またEventContextがlauncher
に設定されている場合にのみアクセス可能です。
EventContext: ポップアップが複数のオブジェクトによって共有されている場合、たとえばポップアップ内のウィンドウに表で選択された行に関する情報が表示される場合は、launcherを選択します。この属性をlauncher
に設定すると、イベント・リスナーがコールされる前にクリックされた行が現在の行になり、その行のデータのみ返されます。詳細は、16.2.5項「実行時に行われる処理: popupコンポーネントのイベント」を参照してください。
PopupCancelListener: ウィンドウが閉じられるときに呼び出すロジックでハンドラに評価されるEL式に設定します。
必要に応じて、「AutoCancel」ドロップダウンで値を選択します。この値によって、自動取消の動作が決定します。詳細は、16.6項「インライン・ポップアップの自動取消の制御」を参照してください。
「コンポーネント」ウィンドウの「レイアウト」パネルの「セカンダリ・ウィンドウ」グループから、「パネル・ウィンドウ」をpopup
コンポーネントに直接の子としてドラッグ・アンド・ドロップします。
「プロパティ」ウィンドウの「共通」セクションを開いて、次の属性を設定します。
Modal: ウィンドウをモーダルにするかどうかを選択します。モーダル・ウィンドウでは、ユーザーはウィンドウが閉じられるまでメイン・ページに戻ることができません。
CloseIconVisible: 「閉じる」アイコンをウィンドウに表示するかどうかを選択します。
Title: ウィンドウにタイトルとして表示されるテキスト。
Resize: ユーザーがダイアログのサイズを変更できるようにするかどうかを選択します。デフォルトはoff
です。
StretchChildren: 子コンポーネントをウィンドウに合せて拡大するかどうかを選択します。first
に設定されている場合、ウィンドウは単一の子コンポーネントを拡大します。ただし、拡大できる子コンポーネントであることが必要です。詳細は、9.2.1項「ジオメトリ管理およびコンポーネントの拡大」を参照してください。
注意: Resizeをon に設定するかStretchChildrenをfirst に設定した場合は、ContentWidthおよびContentHeightも設定する必要があります(手順6を参照)。それ以外の場合、サイズはデフォルトで250x250ピクセルになります。 |
ウィンドウのサイズを固定する場合、またはResizeをon
に設定済かStretchChildrenをfirst
に設定済の場合は、「外観」セクションを開いて次の属性を設定します。
ContentHeight: 目的の高さをピクセル単位で入力します。
ContentWidth: 目的の幅をピクセル単位で入力します。
ヒント (resize 属性がon に設定されている場合)ユーザーは実行時にこれらの属性の値を変更できますが、アプリケーションが変更の永続性を使用するように構成されていないかぎり、ユーザーがページを終了すると値は保持されません。変更の永続性の有効化および使用方法の詳細は、第34章「JSFページでのユーザー・カスタマイズの許可」を参照してください。 |
注意: アクション・コンポーネントをshowPopupBehavior タグなしで使用してダイアログを起動する場合に、そのアクション・コンポーネントのwindowHeight 属性およびwindowWidth 属性の値が設定されている場合は、アクション・コンポーネントでの値がcontentHeight およびcontentWidth の値よりも優先されます。showPopupBehavior タグの詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。 |
ウィンドウのデータを表示または収集するコンポーネントを挿入します。panelGroupLayout
などのレイアウト・コンポーネントを使用してコンポーネントを含めます。
親ページにロジックを追加して、ポップアップとパネル・ウィンドウを呼び出します。詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。
popupコンポーネント内でメニュー・コンポーネントを使用して、ポップアップ・メニューを作成します。特定のトリガーに基づいて、別のコンポーネントからコンテキスト・メニュー・ポップアップを呼び出すことができます。かわりに、ツールバーのツールバー・ボタンでポップアップ・メニューを起動する場合は、15.3項「ツールバーの使用方法」を参照してください。
始める前に:
popup
コンポーネントの属性およびその他のコンポーネントがポップアップ・メニューの機能に与える影響を理解することが役立つ場合があります。詳細は、16.2項「ポップアップの宣言的な作成」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
インライン・ポップアップ・メニューを作成する手順:
「コンポーネント」ウィンドウの「レイアウト」パネルの「セカンダリ・ウィンドウ」グループから、「ポップアップ」をドラッグしてページにドロップします。
ヒント 位置はpopupの呼出しに使用されるコンポーネントによって決定されるため、popupコンポーネントがページに表示されるかどうかは関係ありません。ただし、popup コンポーネントはform コンポーネント内にある必要があります。 |
「プロパティ」ウィンドウの「共通」セクションを開いて、次の属性を設定します。
ContentDelivery: ポップアップのコンポーネントにコンテンツが配信される方法を決定します。
Animate: コンテキスト・メニューのアニメーションを構成します。詳細は、16.2.7項「アニメーションおよびポップアップに関する必知事項」を参照してください。
LauncherVar: 起動コンポーネントの参照に使用する変数名(source
など)を入力します。この変数は、popup
またはその子コンポーネントでのイベント配信時にのみ、またEventContextがlauncher
に設定されている場合にのみアクセス可能です。
EventContext: ポップアップが複数のオブジェクトによって共有されている場合、たとえばポップアップ内のメニューに表で選択された行に関する情報が表示される場合は、launcherに設定します。この属性をlauncher
に設定すると、イベント・リスナーがコールされる前にクリックされた行が現在の行になり、その行のデータのみ返されます。詳細は、16.2.5項「実行時に行われる処理: popupコンポーネントのイベント」を参照してください。
必要に応じて、「AutoCancel」ドロップダウンで値を選択します。この値によって、自動取消の動作が決定します。詳細は、16.6項「インライン・ポップアップの自動取消の制御」を参照してください。
「コンポーネント」ウィンドウで、「メニュー」をpopup
コンポーネントに直接の子としてドラッグ・アンド・ドロップし、commandMenuItem
コンポーネントを使用してメニューを作成します。作成方法は、15.2.1項「メニュー・バーのメニューの作成および使用方法」を参照してください。
親ページにロジックを追加して、ポップアップとポップアップ・メニューを呼び出します。詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。
noteWindow
コンポーネントを使用して、読取り専用テキストを表示します。noteWindow
コンポーネントを含むpopup
コンポーネントは、form
コンポーネントに含まれている必要があります。
始める前に:
noteWindow
コンポーネントの属性およびその他のコンポーネントが機能に与える影響を理解することが役立つ場合があります。詳細は、16.2項「ポップアップの宣言的な作成」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
インライン・ウィンドウを作成する手順:
「コンポーネント」ウィンドウの「レイアウト」パネルの「セカンダリ・ウィンドウ」グループから、「ポップアップ」をドラッグしてページにドロップします。
ヒント 位置はpopupの呼出しに使用されるコンポーネントによって決定されるため、popupコンポーネントがページに表示されるかどうかは関係ありません。ただし、popup コンポーネントはform コンポーネント内にある必要があります。 |
「プロパティ」ウィンドウの「共通」セクションを開いて、次の属性を設定します。
ContentDelivery: ポップアップのコンポーネントにコンテンツが配信される方法を決定します。
Animate: ノート・ウィンドウのアニメーションを構成します。詳細は、16.2.7項「アニメーションおよびポップアップに関する必知事項」を参照してください。
LauncherVar: 起動コンポーネントの参照に使用する変数を入力します。この変数は、popup
またはその子コンポーネントでのイベント配信時にのみ、またEventContextがlauncher
に設定されている場合にのみアクセス可能です。
EventContext: ポップアップが複数のオブジェクトによって共有されている場合、たとえばポップアップ内のウィンドウに表で選択された行に関する情報が表示される場合は、launcherを選択します。この属性をlauncher
に設定すると、イベント・リスナーがコールされる前にクリックされた行が現在の行になり、その行のデータのみ返されます。詳細は、16.2.5項「実行時に行われる処理: popupコンポーネントのイベント」を参照してください。
PopupCancelListener: ウィンドウが閉じられるときに呼び出すロジックでハンドラに評価されるEL式に設定します。
必要に応じて、「AutoCancel」ドロップダウンで値を選択します。この値によって、自動取消の動作が決定します。詳細は、16.6項「インライン・ポップアップの自動取消の制御」を参照してください。
「コンポーネント」ウィンドウの「レイアウト」パネルの「セカンダリ・ウィンドウ」グループから、「ノート・ウィンドウ」をpopup
コンポーネントに直接の子としてドラッグ・アンド・ドロップします。
ウィンドウに表示するテキストを入力する手順:
「ソース」タブをクリックしてページのソース・コードを表示します。
af:noteWindow
タグから閉じるスラッシュ(/)を削除します。
af:noteWindow
タグの下に、表示するテキストを単純なHTMLタグを使用して入力し、閉じるaf:noteWindow
タグで終了します。
例16-4に、ノート・ウィンドウのテキストを表示します。
例16-4 af:noteWindowタグ内のテキスト
<af:popup id="popupHead" contentDelivery="lazyUncached"> <af:noteWindow inlineStyle="width:200px" id="nw3"> <p>In anatomy, the head of an animal is the rostral part (from anatomical position) that usually comprises the brain, eyes, ears, nose, and mouth (all of which aid in various sensory functions, such as sight, hearing, smell, and taste). Some very simple animals may not have a head, but many bilaterally symmetric forms do.</p> </af:noteWindow> </af:popup>
図16-4に、ノートがどのように表示されるかを示します。
必要に応じて、「プロパティ」ウィンドウの「動作」セクションを開いて「AutoDismissalTimeout」フィールドで秒数を指定します。指定する値によって、アプリケーションが自動的に閉じる前にノート・ウィンドウが表示される秒数が決定されます。指定する値によって、デフォルトの自動消去動作がオーバーライドされます。エンド・ユーザーがノート・ウィンドウのコンテンツにマウスを移動すると、自動消去動作はノート・ウィンドウのデフォルトの自動消去動作に戻るため、このオーバーライドは取り消されます。デフォルトの自動消去動作では、フォーカスが起動ソースまたはポップアップのコンテンツから変更された場合にノート・ウィンドウが終了します。
注意: タイムアウト取消期間はマウス・カーソルを重ねることでトリガーされ、キーボードの同等の操作は用意されていないため、このプロパティで有効化された機能は使い勝手がよいとは言えません。 |
親ページにロジックを追加して、ポップアップとノート・ウィンドウを呼び出します。詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。
コンテンツがポップアップに配信され、contentDelivery
属性がlazy
またはlazyUncached
に設定されている場合は、popupFetch
サーバー側イベントが起動します。このイベントには、eventContext
とlauncherVar
の2つのプロパティがあります。eventContext
プロパティは、イベントの配信元のコンテキストがポップアップのコンテキスト(self
)とポップアップを起動したコンポーネント(launcher
)のどちらであるかを決定します。コンテキストをlauncher
に設定すると、フレームワークはポップアップを起動したコンポーネントがポップアップではなくイベントを起動したかのうように動作するため、ポップアップが複数のコンポーネントによって共有されている場合に非常に便利な可能性があります。変数を使用して表の行をスタンプ・アウトするのと同様の方法で、launcherVar
プロパティを使用して現在のランチャを追跡します。
たとえば、表の中の列で、link
コンポーネントを使用して人物のファースト・ネームを表示するとします。このlink
コンポーネントにマウスを置くと、ポップアップnoteWindow
が起動されて、その人物のフル・ネームが表示されます。このnoteWindow
は表のすべての行で使用されますが、表示する必要があるのはクリックされたlink
コンポーネントが存在する行のフル・ネームのみであるため、eventContext
プロパティを使用して、コンテキストがその行となるようにします(例16-5を参照)。
例16-5 共有ポップアップでのeventContextの使用
<af:popup id="noteWindow" contentDelivery="lazyUncached" eventContext="launcher" launcherVar="source"> <af:noteWindow> <af:outputText value="#{testBean.fullName}"/> </af:noteWindow> </af:popup> <af:table var="person" value="#{testBean.people}"> <af:column id="firstName"> <af:link text="#{person.firstName}"> <af:showPopupBehavior popupId="::noteWindow" triggerType="mouseHover"/> </af:link> </af:column> </af:table>
変数ソースを使用して、ソースから値を取得し、それらを適用するか、値を設定できます。たとえば、例16-6に示すようにsetPropertyListener
およびclientAttribute
タグを使用して、表で使用されるpeople
オブジェクトの姓名値を取得し、それをウィンドウで使用されるtestBean
のfullName
プロパティの値として設定できます。
例16-6 launcherVarプロパティを使用したポップアップのコンポーネントの値の設定
<af:popup id="noteWindow" contentDelivery="lazyUncached" eventContext="launcher" launcherVar="source"> <af:noteWindow> <af:outputText value="#{testBean.fullName}"/> </af:noteWindow> <af:setPropertyListener from="#{source.attributes.fullName}" to="#{testBean.fullName}" type="popupFetch"/> </af:popup> <af:table var="person" value="#{testBean.people}"> <af:column id="firstName"> <f:facet name="header"> <af:outputText value="First Name"/> </f:facet> <af:link text="#{person.firstName}"> <af:showPopupBehavior popupId="::noteWindow" triggerType="mouseHover"/> <af:clientAttribute name="fullName" value="#{person.fullName}"/> </af:link> </af:column> </af:table>
この例では、launcherVar
プロパティ・ソースはpopupFetch
イベントを使用して現在の行の姓名を取得します。setPropertyListener
タグの使用の詳細は、5.7.2項「Javaコードを記述せずにpageFlowScopeスコープを使用する方法」を参照してください。クライアント属性の使用の詳細は、4.6項「クライアント側コンポーネントに対するボーナス属性の使用」を参照してください。showPopupBehavior
タグの詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。
ポップアップは、次のクライアント側イベントも起動します。
popupOpening
: ポップアップが起動されると、開始されます。このイベントがクライアント側のリスナーで取り消されると、ポップアップは表示されません。
popupOpened
: ポップアップが表示可能になった後、起動されます。このイベントを使用する1つの例は、ポップアップでデフォルトのフォーカスをオーバーライドするカスタム・ルールの作成です。
popupCanceled
: 自動消去やポップアップ・クライアント・コンポーネントのcancelメソッドの明示的な起動によってポップアップが予期せずに閉じると、起動します。このクライアント側イベントには、サーバー側の対応するイベントもあります。
popupClosed
: ポップアップが非表示の場合、またはポップアップが予期せず閉じた場合に起動します。このクライアント側イベントには、サーバー側の対応するイベントもあります。
「はい」ボタンのクリックなど、肯定的な状況でポップアップが閉じられた場合は非表示になります。「閉じる」アイコンまたは「取消」ボタンがクリックされた場合など、ポップアップが自動消去によって閉じられた場合は取り消されます。どちらのタイプの消去でも、popupClosed
クライアント側イベントが発生します。ポップアップを取り消すと、サーバー側に対応するイベントを持つクライアント側popupCanceled
イベントも発生します。イベントに対しステータス登録されたリスナーがないかぎり、イベントはサーバーに伝播されません。伝播される場合、ポップアップの子コンポーネントの処理が阻止されるため、送信された値と検証は無視されます。ポップアップが取り消された場合に必要な処理を行うロジックを含む、popupCanceled
イベントのリスナーを作成できます。
クライアント側イベントに基づくロジックを呼び出す場合は、カスタム・クライアント・リスナー・メソッドを作成できます。詳細は、4.4項「クライアント・イベントのリスニング」を参照してください。クライアント・イベントに基づいてサーバー側ロジックを呼び出す場合は、そのロジックを呼び出すserverListener
タグを追加できます。詳細は、6.4項「クライアントからサーバーへのカスタム・イベントの送信」を参照してください。
dialog
コンポーネントは、エンド・ユーザーが「OK」、「はい」、「いいえ」または「取消」ボタンをクリックしたときにdialogEvent
を生成します。dialog
コンポーネントは、エラーまたはそれ以上の重大度のメッセージがページに存在しなければ、エンド・ユーザーが「OK」、「はい」または「いいえ」ボタンをクリックしたときに自動的に非表示になります。「取消」ボタンまたは閉じるアイコンを選択するエンド・ユーザーは、親popup
コンポーネントを取り消し、ポップアップ取消イベントを生成します。
「OK」、「はい」、「いいえ」または「取消」ボタンによって返されるdialogEvent
をインターセプトするようにdialogListener
属性を構成できます。「OK」、「はい」および「いいえ」ボタンによって返されるdialogEvent
のみ、サーバーに伝播されます。「取消」ボタン、[Esc]キーおよび閉じるアイコンによって返されるdialogEvent
は、クライアント・ダイアログ・イベントをキューに入れ、サーバーに伝播しません。
dialog
コンポーネントを起動するアクション・コンポーネントのactionListener
が、dialog
コンポーネントから制御が戻った後にアクション(たとえば、inputText
コンポーネントの更新)を実行するように構成されている場合は、inputText
コンポーネントに対してresetValue()
を呼び出すことも必要になります。これが必要になるのは、アクション・コンポーネントのimmediate
の値がtrue
に設定されている場合です。
dialog
コンポーネントおよびpopup
コンポーネントによって起動されるイベントの詳細は、Oracle ADF Facesタグ・リファレンスを参照してください。
ポップアップを表示するためにpopup
コンポーネント内でレンダリングするdialog
、panelWindow
、menu
およびnoteWindow
コンポーネントは、レンダリング時にアニメーションを使用できます。A.6.2.1項「アニメーションの有効化」で説明されているように、アプリケーションのtrinidad-config.xml
ファイルで、<animation-enabled>
要素をtrue
に設定することにより、アプリケーションのこれらのコンポーネントに対してアニメーションを有効化します。
さらに、アプリケーションのADFスキンの-tr-animate
および-tr-open-animation-duration
ADFスキン・プロパティに対して値を書き込むことにより、これらのコンポーネントに対してアニメーションをカスタマイズまたは無効化を行うこともできます。例16-7では、アプリケーションのmenu
コンポーネントに対してアニメーションを許可し、dialog
コンポーネントに対してアニメーションを無効化する方法を示しています。
例16-7 アニメーションのADFスキン・プロパティ
/** Animate menu components and specify 10 seconds as the duration to open a menu or a popup menu */ af|menu { -tr-open-animation-duration: 10000; -tr-animate: true; } /** Disable animation for dialog components */ af|dialog { -tr-animate: false; }
popup
コンポーネントの特定のインスタンスのアニメーション動作は、次のリストに示すように、popup
コンポーネントのanimate
プロパティに適切な値を設定することによって構成できます。
default: アプリケーションのtrinidad-config.xml
ファイル内の<animation-enabled>
要素およびアプリケーションのADFスキンのADFスキン・プロパティがポップアップ・コンポーネントのアニメーション動作を決定します。
false: trinidad-config.xml
ファイルまたはアプリケーションのADFスキンでアプリケーションに対して構成したアニメーション設定に関係なく、ポップアップのアニメーションを無効にします。たとえば、menu
コンポーネントを表示するpopup
コンポーネントにこの値を設定すると仮定します。アニメーションが有効化され、例16-7に示されたmenu
コンポーネントにADFスキン・プロパティが含まれていても、特定のポップアップ・メニューに対して、アニメーションが無効化されます。
true: アプリケーションのADFスキン内の-tr-animate: false
エントリをオーバーライドします。たとえば、dialog
コンポーネントをレンダリングするpopup
コンポーネントに対してanimate
プロパティをtrue
に設定した場合、例16-7に示されたdialog
コンポーネントにADFスキン・プロパティが構成されていても、ポップアップ・ダイアログは、レンダリング時にアニメーションを使用します。
アニメーションのADFスキン・プロパティの詳細は、Oracle ADF Facesスキン・セレクタ・タグ・リファレンスを参照してください。
ADF Facesのコンポーネントでは、ポップアップの表示または非表示にJavaScriptは不要です。showPopupBehavior
タグは宣言的なソリューションを提供するため、popup
コンポーネントを開くJavaScriptを作成したり、スクリプトをpopup
コンポーネントに登録したりする必要はありません。クライアントの動作タグの詳細は、6.6項「ADF Facesのクライアントの動作タグの使用」を参照してください。
showPopupBehavior
タグは、指定されたイベント(たとえば、アクション・コンポーネントのactionEvent
やshowDetail
コンポーネントのdisclosureEvent
)をリスニングします。ただし、showPopupBehavior
タグはサーバーへのそのイベントの配信も取り消します。したがって、showPopupBehavior
タグがリスニングするイベントに基づいてサーバー側ロジックを起動する必要がある場合は、JavaScriptを使用してポップアップを起動するか、16.4項「ポップアップのプログラムによる呼出し」の説明に従ってpopup
コンポーネントをプログラムで起動する必要があります。
showPopupBehavior
タグは、ポップアップを呼び出すコンポーネントとともに使用します。たとえば、ダイアログを呼び出すbutton
コンポーネントや、右クリックされたときにコンテキスト・メニューを呼び出すinputText
コンポーネントです。
始める前に:
popupコンポーネントを宣言的に呼び出す場合は、使用可能な構成オプションに関する知識が役立つ場合があります。詳細は、16.3項「ポップアップの宣言的な呼出し」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
次のタスクを完了する必要があります。
showPopupBehaviorタグを使用する手順:
「コンポーネント」ウィンドウの「操作」パネルの「動作」グループから、「ポップアップ表示動作」をドラッグし、ポップアップを呼び出すコンポーネントに子としてドロップします。
「プロパティ」ウィンドウで、PopupIdプロパティのフィールドにマウスを置いて表示されたアイコンをクリックし、表示されたコンテキスト・メニューで「編集」を選択します。「プロパティの編集: PopupId」ダイアログを使用して、呼び出すポップアップ・コンポーネントを選択し、「OK」をクリックします。
「プロパティ」ウィンドウの「TriggerType」ドロップダウン・メニューで、ポップアップを呼び出すトリガーを選択します。デフォルトはaction
で、アクション・コンポーネントに対して使用できます。マウスが右クリックされたときにポップアップをトリガーするにはcontextMenu
を使用します。カーソルがコンポーネント上に置かれたときにポップアップをトリガーするにはmouseHover
を使用します。カーソルがコンポーネントから離れるとポップアップが閉じます。ポップアップをトリガーできるコンポーネントおよびマウス/キーボード・イベントの詳細なリストは、Oracle ADF Facesタグ・リファレンスのshowPopupBehavior
タグのドキュメントを参照してください。
注意: showPopupBehavior タグのtriggerType 属性に対して選択されたイベントは、サーバーに配信されません。このイベントに基づいてサーバー側ロジックを起動する必要がある場合は、JavaScriptまたはカスタム・イベントを使用してポップアップを呼び出すか(6.4項「クライアントからサーバーへのカスタム・イベントの送信」を参照)、ポップアップをプログラムで呼び出す必要があります(16.4項「ポップアップのプログラムによる呼出し」を参照)。 |
AlignIdプロパティのフィールドにマウスを置いて表示されたアイコンをクリックし、表示されたコンテキスト・メニューで「編集」を選択します。「プロパティの編集: AlignId」ダイアログを使用して、ポップアップの位置合せの基準となるコンポーネントを選択します。
「位置合せ」ドロップダウン・メニューから、前の手順で選択したコンポーネントを基準としてポップアップを配置する方法を選択します。
注意: dialog およびpanelWindow コンポーネントでは、対応するポップアップをユーザーが移動できるため、alignId またはalign 属性は不要です。AlignIdを設定した場合、値はダイアログまたはウィンドウの位置を手動でドラッグ・アンド・ドロップすることでオーバーライドされます。AlignIdまたはAlignに値が入力されていない場合、ダイアログまたはウィンドウはブラウザの中央に開きます。
また、 |
設計時に、「プロパティ」ウィンドウで選択したソース・ファイルの中に、対応する値がJDeveloperによって生成されます。例16-8に示すサンプル・コードでは、ボタン「Show Popup」がクリックされると、id
属性が"popup2
"であるaf:popup
コンポーネントにテキストが表示されます。
例16-8 ボタン・コンポーネントに関連付けられたshowPopupBehavior
<af:button text="Click me" clientComponent="true" id="popupButton2"> <showPopupBehavior popupId="popup2" alignId="popupButton2" align="afterStart"/> </af:button> ... <af:popup id="popup2"> <af:panelGroupLayout layout="vertical"> <af:outputText value="Some"/> <af:outputText value="popup"/> <af:outputText value="content"/> </af:panelGroupLayout> </af:popup>
例16-8のコードはADF Facesに、ポップアップの内容をid
属性で指定されたbutton
に合せることと、配置の位置としてafterStart
(ポップアップをボタンのすぐ下に配置する)を使用することを指示するものです(図16-5を参照)。
アクション・コンポーネントによって生成されたactionEvent
への応答として、プログラムでポップアップを表示、非表示または取り消すことができます。actionEvent
をサーバーに即時に配信してサーバー側ロジックを起動できるようにし、サーバー側ロジックの起動結果に対してポップアップを表示、非表示または取り消すことができるようにするには、この機能を実装します。
ここで説明するポップアップのプログラムによる呼出しは、showPopupBehavior
タグがactionEvent
をサーバーに即時に配信しない、16.3項「ポップアップの宣言的な呼出し」で説明したポップアップの呼出し方法とは異なります。
16.2項「ポップアップの宣言的な作成」で説明したように、コンポーネント(dialog
、panelWindow
、menu
またはnoteWindow
)の1つをpopup
コンポーネントに配置することで、目的のタイプのポップアップを作成します。popup
コンポーネントが呼出し時に適切なコンテキストにあることを確認してください。これを簡単に行う方法の1つは、例16-9に示すようにページのバッキングBeanにバインドすることです。
これが完了したら、アクション・コンポーネントのactionListener
属性がpopup
コンポーネントを参照するように構成します。具体的には、ポップアップ・バインディングのアクセッサを呼び出します。
ポップアップの呼出し、取消または非表示を行うバッキングBeanメソッドのコードを作成します。例16-10に示すshowPopup
バッキングBeanメソッドでは、HINT_LAUNCH_ID
ヒントを使用してアクション・コンポーネントを指定しています。このコンポーネントからactionEvent
がこのメソッドに渡されます。p1
を使用して参照されているポップアップに対して、show
メソッドを呼び出します。
例16-10 ポップアップを呼び出すバッキングBeanメソッド
public void showPopup(ActionEvent event) { { FacesContext context = FacesContext.getCurrentInstance(); UIComponent source = (UIComponent)event.getSource(); String alignId = source.getClientId(context); RichPopup.PopupHints hints = new RichPopup.PopupHints(); hints.add(RichPopup.PopupHints.HintTypes.HINT_ALIGN_ID,source) .add(RichPopup.PopupHints.HintTypes.HINT_LAUNCH_ID,source) .add(RichPopup.PopupHints.HintTypes.HINT_ALIGN, RichPopup.PopupHints.AlignTypes.ALIGN_AFTER_END); p1.show(hints); }
例16-11に、actionEvent
に対してポップアップを取り消すバッキングBeanメソッドを示します。
例16-11 ポップアップを取り消すバッキングBeanメソッド
public void cancelPopupActionListener(ActionEvent event) {
FacesContext context = FacesContext.getCurrentInstance();
p1.cancel();
}
例16-12に、actionEvent
に対してポップアップを非表示にするバッキングBeanメソッドを示します。
例16-12 ポップアップを非表示にするバッキングBeanメソッド
public void hidePopupActionListener(ActionEvent event) {
FacesContext context = FacesContext.getCurrentInstance();
p1.hide();
}
前の例のp1
オブジェクトは、次のパッケージのRichPopup
クラスのインスタンスを参照します。
oracle.adf.view.rich.component.rich.RichPopup
RichPopup
の詳細は、Oracle ADF Faces Java APIリファレンスを参照してください。
ポップアップの表示、取消または非表示を行うバッキングBeanメソッドを参照するように、アクション・コンポーネントのactionListener
属性を構成します。
始める前に:
popupコンポーネントをプログラムで呼び出す場合は、使用可能な構成オプションに関する知識が役立つ場合があります。詳細は、16.4項「ポップアップのプログラムによる呼出し」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
次のタスクを完了する必要があります。
ポップアップをプログラムで呼び出す手順:
「コンポーネント」ウィンドウの「一般コントロール」パネルから、アクション・コンポーネントをJSFページにドラッグ・アンド・ドロップします。たとえば、「ボタン」です。
「プロパティ」ウィンドウで、「動作」セクションを開いて次の属性を設定します。
PartialSubmit: trueを選択すると、ユーザーがアクション・コンポーネントをクリックした後にFusion Webアプリケーションのページ全体がレンダリングされることはなくなります。デフォルト値(false
)を指定すると、エンド・ユーザーがアクション・コンポーネントを呼び出した後にアプリケーションのページ全体がレンダリングされます。ページ・レンダリングの詳細は、第8章「部分ページ・コンテンツの再レンダリング」を参照してください。
ActionListener: 評価した結果がバッキングBeanメソッドとなるEL式を指定します。実行時にエンド・ユーザーがアクション・コンポーネントを呼び出したときに、このメソッドのロジックが実行されます。
手順2でアクション・コンポーネントがactionEvent
を渡すときに呼び出される、バッキングBeanのロジックをプログラミングします。
詳細は、例16-10「ポップアップを呼び出すバッキングBeanメソッド」、例16-11「ポップアップを取り消すバッキングBeanメソッド」または例16-12「ポップアップを非表示にするバッキングBeanメソッド」を参照してください。
実行時に、エンド・ユーザーは、ポップアップの表示、取消または非表示を行うためにサーバー側メソッドを呼び出すように構成されているアクション・コンポーネントを呼び出すことができます。たとえば、図16-6に、popup
コンポーネントの内部にレンダリングするpanelWindow
コンポーネントを示します。panelWindow
コンポーネントは、2つのボタン(「取消」および「非表示」)を公開します。前者はcancel
メソッド、後者はhide
メソッドを呼び出します。ページのtable
コンポーネントのSupplierName列内にレンダリングされているlink
コンポーネントをエンド・ユーザーが呼び出すと、ポップアップが表示されます。
ユーザーがページでタスクを完了するのにより多くの情報が必要だが、ページにアクセスするたびに必要にはならない情報や、情報を表示するためにダイアログを起動する複数のボタンによって、ページが乱雑になるのは望ましくない場合があります。コンポーネントの右クリックで起動するポップアップに情報を表示することも考えられますが、その情報をポップアップで参照できることがユーザーからはわかりません。
contextInfo
コンポーネントでは、ポップアップに追加情報を表示し、追加情報が使用可能であることをユーザーに通知することもできます。contextInfo
コンポーネントを、コンテキスト情報をサポートするコンポーネントのコンテキスト・ファセットに配置すると、図16-7に示すように、小さなオレンジ色の正方形がコンポーネントの左上に表示されます。
ユーザーが正方形の上にカーソルを置くと、図16-8に示すようにノート・アイコンの付いた大きな三角形とツールチップが表示され、追加情報が使用可能であることが示されます。
showPopupBehavior
タグがcontextInfo
コンポーネントの子の1つであるため、参照されるポップアップはユーザーが情報アイコンをクリックしたときに表示されます(図16-9を参照)。
showPopupBehavior
コンポーネントをcontextInfo
コンポーネントの子として使用すると、ポップアップ・コンポーネントを、contextInfo
コンポーネントを含むコンポーネントに位置揃えできます。
始める前に:
contextInfo
コンポーネントの親になるコンポーネントを作成します。次のコンポーネントではcontextInfo
コンポーネントがサポートされます。
column
link
inputComboboxListOfValues
inputListOfValues
inputText
outputFormatted
outputText
selectOneChoice
16.2項「ポップアップの宣言的な作成」の説明に従って、表示するポップアップを作成します。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
contextInfoコンポーネントを使用する手順:
「コンポーネント」ウィンドウの「一般コントロール」パネルから、「コンテキスト情報」をドラッグし、追加情報のアイコンを表示するコンポーネントのContext
ファセットにドロップします。
ヒント ファセットがビジュアル・エディタに表示されていない場合は、「構造」ウィンドウでコンポーネントを右クリックして「ファセット - コンポーネント名」→「コンテキスト」を選択します。ページで使用されているファセットは、ファセット名の前にチェックマークが表示されます。 |
contextInfo
コンポーネントが表示されるときにサーバー側ロジックを実行する必要がある場合は、「プロパティ」ウィンドウの「動作」セクションを開いて、イベントを処理できるハンドラにContextInfoListenerをバインドします。
注意: showPopupBehavior タグを使用してポップアップを起動する場合は、サーバーへのcontextInfoEventの配信が取り消されます。このイベントに基づいてサーバー側ロジックを起動する必要がある場合は、6.4項「クライアントからサーバーへのカスタム・イベントの送信」の説明に従って、JavaScriptまたはカスタム・イベントを使用してポップアップを起動する必要があります。 |
「コンポーネント」ウィンドウの「操作」パネルの「動作」グループから、「ポップアップ表示動作」をドラッグし、contextInfo
に子としてドロップします。
エディタでshowPopupBehavior
タグが選択されている状態で、「プロパティ」ウィンドウで属性を設定します(16.3.1項「af:showPopupBehaviorタグを使用してポップアップを宣言的に呼び出す方法」の説明を参照)。TriggerTypeには、contextInfo
と入力してください。
popup
コンポーネントを他の多数のコンポーネントとともに使用して、インライン・ポップアップを作成できます。つまり、インライン・ウィンドウ、ダイアログおよびポップアップ・メニューです。他のコンポーネントには次のものがあります。
インライン・ダイアログを作成するためのダイアログ・コンポーネント
詳細は、16.2.1項「ダイアログの作成方法」を参照してください。
インライン・ウィンドウを作成するためのpanelWindow
コンポーネント
詳細は、16.2.2項「パネル・ウィンドウの作成方法」を参照してください。
ポップアップ・メニューを作成するためのメニュー・コンポーネント
詳細は、16.2.3項「ポップアップ・メニューの作成方法」を参照してください。
ノート・ウィンドウを作成するためのnoteWindow
コンポーネント
詳細は、16.2.4項「ノート・ウィンドウの作成方法」を参照してください。
デフォルトでは、Fusion Webアプリケーションは、インライン・ポップアップを定義するメタデータが置換された場合にインライン・ポップアップを自動的に取り消します。この状況が発生するシナリオの一部を次に示します。
partialSubmit
プロパティがfalse
に設定されているアクション・コンポーネントの呼出し。Fusion Webアプリケーションは、このようなアクション・コンポーネントを呼び出した後でページ全体をレンダリングします。対照的に、アクション・コンポーネントのpartialSubmit
プロパティがtrue
に設定されている場合は、Fusion Webアプリケーションはコンテンツを部分的にレンダリングします。ページ・レンダリングの詳細は、第8章「部分ページ・コンテンツの再レンダリング」を参照してください。
エンド・ユーザーがコンテンツを表示または非表示にするための切替えアイコンをレンダリングするコンポーネントは、popup
コンポーネントをホストします。たとえば、showDetailItem
コンポーネントやpanelTabbed
コンポーネントなどです。切替えアイコンをレンダリングするコンポーネントの使用の詳細は、9.9項「コンテンツの動的な表示および非表示」を参照してください。
Fusion Webアプリケーションがインライン・ポップアップを表示するときにフェイルオーバーが発生します。フェイルオーバー時に、Fusion Webアプリケーションはページ全体を置換します。
前のリストで説明したデフォルトの動作は、インライン・ポップアップ・コンポーネントの自動取消を無効にすることで変更できます。これは、前述のいずれかのイベントが発生した場合にFusion Webアプリケーションがインライン・ポップアップを自動的に取り消さないことを意味します。かわりに、Fusion Webアプリケーションはインライン・ポップアップをリストアします。
popup
コンポーネントのautoCancel
プロパティをdisabled
に設定することで、インライン・ポップアップの自動取消を無効にします。
始める前に:
他のコンポーネントが機能に与える影響を理解することが役立つ場合があります。詳細は、16.6項「インライン・ポップアップの自動取消の制御」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
インライン・ポップアップの自動取消を制御する手順:
「構造」ウィンドウで、自動取消動作を構成するaf:popup
コンポーネントを右クリックし、「プロパティに移動」を選択します
「プロパティ」ウィンドウの「共通」セクションを開き、「AutoCancel」ドロップダウン・リストで「disabled」を選択します。
例16-13に示すように、JDeveloperは、af:popup
コンポーネントのautoCancel
プロパティの値をdisabled
に設定します。
実行時に、Fusion Webアプリケーションは、ページを再レンダリングするコマンドの呼出し前にインライン・ポップアップが表示された場合に、ページを再レンダリングした後でインライン・ポップアップをリストアします。
resetListener
コンポーネントをpopup
コンポーネントとともに使用すると、ユーザーが入力フィールドの入力値をリセットできるようになります。popup
コンポーネントにレンダリングする入力コンポーネントに対してこの機能を実装するユースケースを次に示します。
エンド・ユーザーに、前に入力した不適切な値のリセットを許可する
値を削除する。この場合、エンド・ユーザーが入力した値をアプリケーションがサーバーに送信する前に、popup
コンポーネントがpopupCanceledEvent
を呼び出します。
popupCancelEvent
を呼び出すエンド・ユーザー操作の例としては、ボタンのクリック(たとえば「閉じる」というラベルの付いたボタン)、ポップアップ・ダイアログのタイトル・バーにある取消しアイコンのクリック、[Esc]キーの押下などがあります。
popup
コンポーネントの構成方法に応じて、データがクライアントにキャッシュされることがあります。たとえば、popup
コンポーネントのcontentDelivery
属性をimmediate
に設定した場合、アプリケーションは常にデータをクライアントにキャッシュします。
contentDelivery
属性に対して選択した設定によってpopup
コンポーネントのコンテンツ配信方針がどのように決定されるかの詳細は、16.2項「ポップアップの宣言的な作成」および16.2.5項「実行時に行われる処理: popupコンポーネントのイベント」を参照してください。
例16-14に、contentDelivery
属性がimmediate
に設定され、16.2.1項「ダイアログの作成方法」で説明したようにユーザーのポップアップがdialogEvents
を生成する事前構成済のコントロールとともにdialog
コンポーネントをレンダリングするpopupコンポーネントのメタデータを示します。このシナリオでは、エンド・ユーザーが入力したデータはクライアントにキャッシュされます。アプリケーションは、リセットするデータをサーバーに送信しません。また、dialog
コンポーネントによってレンダリングされる事前構成済コントロールは、検証エラーが発生した場合にポップアップが閉じない原因となることがあります。
例16-14 popupコンポーネントのresetListenerタグ
<af:popup id="popup" contentDelivery="immediate"> <af:resetListener type="popupCanceled"/> </af:popup>
popup
コンポーネントとは無関係にresetListener
コンポーネントを使用する方法の詳細は、20.5.2項「入力フィールドをリセットするためのアクション・コンポーネントの使用方法」を参照してください。
注意: resetListener コンポーネントのtype 属性をpopupCanceled に設定すると、popup コンポーネントのresetEditableValues 属性をwhenCanceled に設定するのと同じ機能が提供されます。popup コンポーネントのresetEditableValues 属性の設定の詳細は、16.2.1項「ダイアログの作成方法」を参照してください。 |
エンド・ユーザーがポップアップの入力フィールドのデータをnull
にリセットできるようにするには、resetListener
コンポーネントのtype
属性をpopupCanceled
に設定します。
始める前に:
popup
コンポーネントでこの機能を構成できるユースケースを理解することが役立つ場合があります。詳細は、16.7項「ポップアップの入力フィールドのリセット」を参照してください。
他のADF Faces機能を使用して追加できる機能について理解することが役立つ場合もあります。詳細は、16.1.2項「ポップアップ・ダイアログ、メニューおよびウィンドウの追加機能」を参照してください。
ポップアップの入力フィールドをリセットする手順:
16.2項「ポップアップの宣言的な作成」の説明に従って、必要なポップアップ・ダイアログのタイプを作成します。
「コンポーネント」ウィンドウの「操作」パネルの「リスナー」グループから、リセット・リスナーをpopup
コンポーネントに直接の子としてドラッグ・アンド・ドロップします。
JDeveloperが表示する「リセット・リスナーの挿入」ダイアログで、popupCanceled
をresetListener
コンポーネントが応答するイベントのタイプとして入力します。
「リセット・リスナーの挿入」ダイアログで「ヘルプ」をクリックして、サポートされる値のリストを表示します。
popup
コンポーネントとresetListener
コンポーネントでエンド・ユーザーがpopup
コンポーネントの入力フィールドをnull
にリセットできるように構成した場合、JDeveloperは例16-15に示すようなエントリを作成します。
例16-15 リセット・リスナーを使用して入力フィールドをリセットするように構成されたpopupコンポーネント
<af:popup id="popupDialog" contentDelivery="lazyUncached" popupCanceledListener="#{demoInput.resetPopupClosed}"> <af:dialog title="Enter an Incorrect Value"> <af:inputText id="it2" label="Always-incorrect Value" value="#{demoInput.value}"> <f:validator binding="#{demoInput.obstinateValidator2}"/> </af:inputText> </af:dialog> <af:resetListener type="popupCanceled"/> </af:popup>
図16-10に示すように、実行時にpopupCanceled
イベントを生成するエンド・ユーザー操作により、resetListener
コンポーネントはpopup
コンポーネントの入力フィールドの値をnull
にリセットします。