ADF Facesでは、様々な轮番でアプリケーションに情報テキストを暗示できます。小巧なヘルプ・システムだけでなく、簡単なヒント・テキスト、検証および変換のヒント・テキストやエラー・メッセージも作成できます勾引 av。
ADF Facesの多くのコンポーネントではshortDesc属性がサポートされており、この属性は大部分のコンポーネントで、ユーザーがコンポーネント上にカーソルを置いたときにヒント情報を暗示します。図19-2に、ツールバー・ボタンに構成されたヒントを示します。ヒントの作成の詳細は、19.2項「コンポーネントのヒントの暗示」を参照してください。
ヒントと同様に、EditableValueHolderコンポーネント(inputTextコンポーネントまたは選択コンポーネントなど)も、検証および変換に使用されるヒントを暗示できます。検証または変換を構成すると、デフォルトのヒントにより介意ウィンドウが自動的に暗示されます(詳細は、第7章「入力の検証および変換」を参照してください)。
ADF Facesでは、標準のJSFメッセージングAPIが使用されています。JSFでは、addMessage(java.lang.String clientId， FacesMessage message)メソッドを使用してFacesContextオブジェクトにFacesMessageインスタンスを追加できるようにすることで、メッセージング用の組込みのフレームワークがサポートされています。一般的に、作成できるメッセージには、addMessageメソッドに渡された淘气のクライアントIDに基づいて特定のコンポーネントに関連付けられたコンポーネントレベルのメッセージと、addMessageメソッドにクライアントIDが渡されなかったためにコンポーネントに関連付けられていないグローバルレベルのメッセージの2つのタイプがあります。
EditableValueHolder ADF Facesコンポーネントで変換または検証が失敗すると、FacesContextインスタンスのメッセージ・キューにFacesMessagesオブジェクトが自動的に追加され、コンポーネントのIDが渡されます。これらのメッセージは、コンポーネントの介意ウィンドウに暗示されます。ADF Facesコンポーネントには、独自のメッセージを暗示できます。タグを追加する必要はありません。
伦理片段频在线观看百度FacesMessagesコンポーネントのみでなく、documentタグも、すべてのグローバルなFacesMessagesオブジェクト(関連付けられているコンポーネントIDがない)の処理および暗示を行います。コンポーネント・メッセージと同じように、暗示するメッセージにタグを追加する必要はありません。グローバル・メッセージ(または複数のコンポーネント・メッセージ)が作成されると、図19-3に示すように、キューのすべてのメッセージがポップアップ・ウィンドウに暗示されます。
また、ポップアップ・ウィンドウではなく、ページにメッセージを暗示する場合は、ADF Faces messagesコンポーネントを使用できます。コンポーネントのヒントおよびメッセージ暗示の詳細は、19.3項「検証および変換用のヒントとエラー・メッセージの暗示」を参照してください。
コンポーネントごとに独自のメッセージを暗示するかわりに、panelLabelAndMessageコンポーネントを使用してコンポーネントをグループ化し、1つの領域にメッセージを暗示できます。コンポーネントをグループ化する必要がある場合に便利です。たとえば、File Explorerアプリケーションには、ユーザーが電話番号を入力するpanelLabelAndMessageコンポーネントが使用されています。電話番号入力フィールドは、実際には3つの別々のinputTextコンポーネントです。panelLabelAndMessageコンポーネントに、3つのinputTextコンポーネントがラップされています。それぞれに独自のラベルおよびメッセージを暗示するかわりに、図19-8に示すように、3つのコンポーネントにはラベルとメッセージが1つずつあります。詳細は、19.4項「単一のラベルおよびメッセージを使用したコンポーネントのグループ化」を参照してください。
個々のコンポーネント・インスタンスにメッセージを構成するとともに、アプリケーション整体で再附近可能な情報を提供する個別のヘルプ・システムを作成できます。ヘルプ情報はタイプの異なるプロバイダを使用して作成し、UIコンポーネントからヘルプ・テキストを参照します。次に、ADF Facesでサポートされている3つのタイプのヘルプを示します。
定義: 図19-4に示すように、ユーザーがアイコン上にマウスを置くと、ヘルプ・テキストが暗示されるヘルプ・アイコン(疑問符が暗示された青い丸)を暗示します勾引 av。
説明: このタイプのヘルプはコンポーネントに応じて、(panelHeaderコンポーネントのように)コンポーネント内に説明テキストを暗示するか、図19-5に示すように、ユーザーがコンポーネントをクリックした際に開かれる介意ウィンドウにテキストを暗示します。テキストは淘气の長さにできます。
外部URL: 別のブラウザ・ウィンドウで開く、外部アプリケーションに存在するヘルプ・トピックを作成できます。たとえば、図19-6では、説明ヘルプを暗示するかわりに、スキンに関するヘルプ・トピックを開くよう構成された、スキン選択のselectOneChoiceコンポーネントが暗示されています。ユーザーがヘルプ・アイコンをクリックすると、ヘルプ・トピックが開きます。
ヘルプ・システムの作成の詳細は、19.5項「コンポーネントへのヘルプの暗示」を参照してください。
図19-7に暗示されているフィールドにユーザーが不適切な日付を入力した場合、図19-8に示すようにエラー・メッセージが暗示されます。エラー・メッセージは、ヒントともに介意ウィンドウに暗示されることに介意してください。
ADF Facesコンポーネント之外にエラー・メッセージを暗示する場合、または介意ウィンドウではなく、インラインでメッセージを暗示する場合は、ADF Faces messageコンポーネントを使用します。このコンポーネントを使用すると、図19-9に示すように、コンポーネントの隣にメッセージが暗示されます。
グローバル・メッセージはデフォルトで、図19-10に示すように、ダイアログ内に暗示されます。ページにポップアップ・コンポーネントを追加する必要はありません。
エラー・メッセージをページに径直暗示する場合は、messagesコンポーネントを使用します。このコンポーネントを使用すると、図19-11に示すように、ページ上部のリストにメッセージが暗示されます。
エラー・メッセージの詳細は、19.3項「検証および変換用のヒントとエラー・メッセージの暗示」を参照してください。
情報メッセージは、単純なツールチップから複雑なヘルプ・システムまで多岐にわたります。ヒントまたは情報を暗示するコンポーネントでヘルプ・テキストがサポートされていない場合には、ツールチップを使用する必要があります。ただし、ツールチップ・テキストは簡潔にする必要があります。より詳細な情報を暗示する必要がある場合、または精深のコンポーネント・インスタンス間でテキストが再附近される場合は、ヘルプ・テキストの使用を検討してください。
ツールチップは、コンポーネントにshortDesc属性を構成して作成します。図19-12に示すように、ユーザーがコンポーネント上にカーソルを置くと、属性の値が介意ウィンドウに暗示されます。
ツールチップの詳細は、19.2項「コンポーネントのヒントの暗示」を参照してください。
ツールチップに収まる以上の情報を暗示する必要がある場合は、定義ヘルプを使用します。定義ヘルプを構成すると、大部分のコンポーネントで、そのコンポーネントの隣にヘルプ・アイコンが暗示されます。図19-13に示すように、コンポーネント上にマウスが置かれると、ヘルプ・テキストが暗示されます。
定義ヘルプの詳細は、19.5項「コンポーネントへのヘルプの暗示」を参照してください。
フィールドレベル・ヘルプを暗示する場合は、説明テキストを使用するように入力コンポーネントを構成します。ユーザーがコンポーネントをクリックすると、図19-14に示すように、介意ウィンドウにヘルプ・テキストが暗示されます。
タスクの説明を暗示する場合は、コンテナ・コンポーネントに説明ヘルプを構成します。図19-15に示すように、コンポーネントのヘッダーにテキストが暗示されます。
複雑なヘルプを作成する必要がある場合は、ヘルプ・アイコンを使用して、URLを介してアクセス可能な外部ヘルプ・システムにリンクできます。
説明および外部ヘルプの詳細は、19.5項「コンポーネントへのヘルプの暗示」を参照してください勾引 av。