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

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

設計時のコンポーネント

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

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

実行時のコンポーネント

入力コンポーネント・エラーの表示」コンポーネントは、実行時にはエラーを表示している対象のコンポーネントによって異なります。

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

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

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

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

表 1. 入力コンポーネント・エラーの表示の全属性

属性名

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

説明

binding

再表示しない

通常はバッキング・ファイルの中でこのコンポーネントを表す UIComponent。

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 スタイル・クラスのスペースで区切られたリスト。この値は、生成されたマークアップ上の「class」属性としてパススルーする必要があります。選択されたコンポーネントのクラス (スタイル・シートなど) を定義します。これは、手動で行うことも、ボタンをクリックして希望するクラスをウィンドウ内で選択して行うこともできます。

title

再表示しない

実行時にツールチップとしてブラウザーに表示されるタイトル・テキストを指定します。

tooltip

再表示しない

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

warnClass

再表示しない

コンポーネントに関連付けられた代替 CSS クラス名。これらが使用される状態は、その名前から判別することができます。

warnStyle

再表示しない

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

関連概念
JavaServer Faces を使用したデータ・アクセス Web アプリケーションの作成
関連タスク
Faces アプリケーションの作成 - 概要
関連資料
Faces コンポーネントの参照
Faces コンポーネントの属性
フォーム内エラーの表示
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.