検証および変換エラーに関連付けられているメッセージは、ページで使用する最も一般的なタイプです。JSF入力コンポーネントと同様に、ADF Faces入力コンポーネントで変換または検証エラーが発生すると、コンポーネントによってFacesMessage
が作成され、FacesContext
インスタンス上のメッセージ・キューに追加されます。ADF Facesの要約および詳細メッセージは、英語と20以上の翻訳で提供されています。
ADF Facesには、変換および検証エラー(必須入力の検証を含む)に対するデフォルト・メッセージが用意されています。標準のJSF入力コンポーネントとは異なり、ADF Facesの入力コンポーネントでは、その固有のメッセージが自動的に表示されます。af:message
などのメッセージ・タグを使用して、入力コンポーネントに関連付けられたメッセージを表示する必要はありません。次に例を示します。
<af:inputText label="Your lucky number "
tip="Enter a number"
required="true">
<af:convertNumber type="number" integerOnly="true"/>
</af:inputText>
無効な値が入力されてフォームが発行された場合は、次の図に示すように、ADF Facesによって、入力フィールドの下にインライン・メッセージと、コンポーネント・ラベルの前に無効アイコンが自動的に表示されます。
ADF Facesのインライン・メッセージは、{0}、{1}、{2}などのパラメータ・プレースホルダを組み込むことができる詳細メッセージです。実行時に、パラメータは、適切で有効な値およびユーザーの入力値で置換されます。次に例を示します。
<af:inputText label="Enter a 3-digit number "
required="true">
<af:validateRegExp pattern="[1-9][2][0-9]"/>
</af:inputText>
入力値が指定したパターンと一致していない場合のデフォルト・メッセージは、次のようになります。
値"{1}"は正規表現パターン"{2}"に一致しません。
このメッセージで、{1}にはユーザーが入力した値が取得され、{2}にはバリデータに設定されたパターンが取得されます。
無効な値(例: cat)が入力された場合、表示されるメッセージは次のようになります。
値"cat"は正規表現パターン"[1-9][2][0-9]"に一致しません。
クライアント側の変換または検証に失敗すると、ADF Facesではアラートにエラー・メッセージが表示されます。アラート・メッセージの形式もオプションのパラメータが含まれる詳細メッセージですが、次の図に示すように、メッセージの前にコンポーネントのラベルが表示されます。
アラートでは、入力値が正規表現に設定したパターンと一致していない場合のデフォルト・メッセージは、次のようになります。
{0} - 値"{1}"は正規表現パターン"{2}"に一致しません。
このメッセージで、{0}にはコンポーネント・ラベル、{1}には入力値、{2}にはバリデータに設定されたパターンが取得されます。
また、必須入力エラーのデフォルトのアラート・メッセージは、次のとおりです。
{0} - 値を入力する必要があります。
前述のコード・スニペットに従うと、最初のフィールドに値が入力されず、2番目のフィールドに値「cat」が入力された場合、アラート・メッセージは次のようになります。
ラッキー番号 - 値を入力する必要があります。
3桁の数字を入力してください - 値"cat"は正規表現パターン"[1-9][2][0-9]"に一致しません。
af:messages
タグを使用して、ページのコンポーネントに関連付けられているすべてのメッセージを表示する場合、ADF Facesでは、次の図に示すように、色付きのメッセージ・ボックスに要約メッセージの番号付きリストが表示されます。
各要約メッセージは、リンクとして表示されるコンポーネントのラベルで始まります。ユーザーがリンクをクリックすると、ADF Facesはメッセージを生成したコンポーネントに移動します。
前述のコード・スニペットに従うと、最初のフィールドに値が入力されず、2番目のフィールドに値「cat」が入力された場合、要約メッセージは次のようになります。
ラッキー番号 - 必須の値です。
3桁の数字を入力してください - 値がパターンと一致しません。
ADF Facesのコンバータとびバリデータ(必須入力の検証も含む)によって提供されるデフォルトのエラー・メッセージをオーバーライドできます。詳細は、「ADF Facesのエラー・メッセージのカスタマイズについて」を参照してください。
ADF Faces入力コンポーネントでのラベルおよびメッセージ表示のサポートについて
ADF Facesの変換および検証エラーについて
ADF Facesのメッセージ・タグについて
ADF Facesでの1つのエラー・メッセージの表示
ADF Facesでの全要約メッセージの表示
Copyright © 1997, 2006, Oracle. All rights reserved.