説明
アプリケーションで使用できるメッセージングには、マウスを合わせると表示されるシンプルなツールチップ からヘルプ・メッセージまで、さまざまな種類があります。
- ADF Facesでは、標準JSFメッセージングAPIが使用されています。 デフォルトでは、コンポーネントに対するすべてのメッセージは、af:noteWindowコ ンポーネントを使用してポップアップ内に表示されます。 af:documentコ ンポーネント(Oracle JDeveloperで作成されたすべてのJSFページにデフォルトで追加されています)はグローバル・メッセージを処理します。また、3つ以上のコン ポーネント・メッセージが存在する場合、 これらもポップアップ内に表示されます。 これらのメッセージをポップアップに表示するためにタグを使用する必要はありません。
- または、af:messageタ グを使用して、コンポーネント・レベルのメッセージをコンポーネントに合わせて表示することもできます。 af:messagesタ グを使用すると、複数のコンポーネント・メッセージを表示することも、ページ上にグローバル・メッセージを表示することもできます。
- af:panelLabelAndMessageコ ンポーネントを使用してメッセージを表示すると、コンポーネントに対するすべてのメッセージが1箇所に表示されるようにコンポーネントがグループ化されま す。
- コンポーネントにshortDesc属性を指定すると、シンプルなツールチップ を表示できます。
- ADF Facesのバリデータおよびコンバータを使用すると、変換や検証が失敗した場合に独自のエラー・メッセージを作成できます。 バリデータおよびコンバータには、デフォルトでそれぞれに応じたヒントが提供されています。
- ヘルプ・アイコンをクリックしたときに表示されるヘルプ・トピックを作成することができます。ヘルプ・トピックは、コンポーネントにフォーカ スがある場合はノート・ウィンドウに表示され、それ以外の場合は外部のブラウザ・ウィンドウが起動されます。
ドキュメント
デモ:
- message
- messages
- panelLabelAndMessage
- 入 力コンポーネントに対するヘルプ
- ヘッ ダー・コンポーネントに対するヘルプ
- フォー ム・コンポーネントに対するヘルプ
- ダ イアログ・コンポーネントに対するヘルプ
- そ の他のコンポーネントに対するヘルプ
- ア コーディオン・コンポーネントに対するヘルプ
- フォー ム・コンポーネントに対するコンバータおよびバリデータのヒント
デモのフル・コード・サンプル:
