入力コンポーネント・エラーの表示

ページが実行されたときに、サーバーによって生成されたエラー・メッセージを表示します。 このコンポーネントは、通常、他の入力コンポーネントにバインドされます。

設計時のコンポーネント

「入力 コンポーネント・エラーの表示」 コンポーネントを、 ページ上にドラッグ・アンド・ドロップします。

「入力コンポーネント・エラーの表示」コンポーネントのボタン

「入力 コンポーネント・エラーの表示」コンポーネントは、 ページ上でこのように表示されます。

デザイン時の「入力コンポーネント・エラーの表示」

実行時のコンポーネント

エラー表示に使用されるコンポーネントに よって、「入力コンポーネント・エラーの表示」コンポーネントは 実行時に変化します。

「プロパティー」ビューと「すべての属性」ビュー

コンポーネントの「プロパティー」ビューには、 コンポーネントに設定できる最も一般的な属性のセットが表示されます。 コンポーネントによっては、制御、アクション、 または他のコンポーネントの追加に関するオプションが 表示される場合もあります。 「プロパティー」ビューを開くには、 「ウィンドウ」 > 「ビューの表示」 > 「プロパティー」とクリックします。

「入力コンポーネント・エラーの表示」 コンポーネントの共通属性は、「プロパティー」ビューの 「h:message」タブに表示されます。 属性の完全なリストについては、「入力コンポーネント・エラーの表示」のすべての属性 の 表を参照してください。

「すべての属性」ビューには、コンポーネントで設定できるすべての属性の表が表示されます。 この表には、「プロパティー」ビューからアクセスできる属性も含まれます。 「すべての属性」ビューに切り替えるには、 「プロパティー」ビューの右上隅にある「すべての属性」アイ コン「すべての属性」
アイコンをクリックします。

表 1. 「入力コンポーネント・エラーの表示」のすべての属性

属性名

「プロパティー」ビューでの表示

説明

binding

非表示

コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。

errorClass

非表示

コンポーネントに関連付けられた代替 CSS クラス名。 これらが使用される状況は、名前によって決まります。

errorStyle

非表示

CSS クラスのスタイル修飾子。

fatalClass

非表示

コンポーネントに関連付けられた代替 CSS クラス名。 これらが使用される状況は、名前によって決まります。

fatalStyle

非表示

CSS クラスのスタイル修飾子。

for

コンポーネントのエラー・メッセージを表示

エラー・メッセージの取り込みおよび表示を行う入力フィールドの ID を指定します。

id

ID

コンポーネントに名前を割り当てます。JSP 内で固有の名前にする必要があります。

infoClass

非表示

コンポーネントに関連付けられた代替 CSS クラス名。 これらが使用される状況は、名前によって決まります。

infoStyle

非表示

CSS クラスのスタイル修飾子。

rendered

非表示

true または false に設定できます。
  • false - コンポーネントは、実行時にブラウザーにレンダリングされません。
  • true - コンポーネントがレンダリングされます。これはデフォルト値です。

showDetail

非表示

エラーの詳細部分を表示させるかどうかを指定します。

showSummary

非表示

メッセージの要約を表示させるかどうかを指定します。

style

スタイル: プロパティー

コンポーネントに対して CSS スタイル情報を指定します (例えば、style="font-size : 8pt ; color : red")。 選択されたコンポーネントのプロパティー (例えば、フォントおよび色) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なプロパティーを選択してください。

styleClass

スタイル: クラス

この要素がレンダリングされるときに適用される、 CSS スタイル・クラスのリスト (スペース区切り)。 この値は、生成されたマークアップの クラス属性として渡されなければなりません。 選択されたコンポーネントのクラス (例えば、スタイルシート) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なクラスを選択してください。

title

非表示

実行時にツールチップとしてブラウザーに表示される、タイトル・テキストを指定します。 コンポーネントの代替テキストが指定されていない場合、 ブラウザーはこのテキストを代替テキストとして使用します。

tooltip

非表示

メッセージの詳細部分を、ツールチップとして表示するかどうかを指定します。

warnClass

非表示

コンポーネントに関連付けられた代替 CSS クラス名。 これらが使用される状況は、名前によって決まります。

warnStyle

非表示

CSS クラスのスタイル修飾子。

関連タスク
JavaServer Faces アプリケーションにおけるエラーの管理
関連資料
フォーム内エラーの表示

フィードバック