フォーム内エラーの表示

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

設計時のコンポーネント

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

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

実行時のコンポーネント

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

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

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

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

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

表 1. フォーム内エラーの表示の全属性

属性名

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

説明

binding

再表示しない

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

errorClass

再表示しない

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

errorStyle

再表示しない

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

fatalClass

再表示しない

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

fatalStyle

再表示しない

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

globalOnly

このページによって生成されたすべてのエラー・メッセージを表示する

特定のコンポーネントに関連付けられていないエラー・メッセージのみを表示します。

コンポーネントが表示するエラー・メッセージを指定します。ページによって生成されたすべてのエラー・メッセージを表示する場合は False、まだ関連付けられていないコンポーネントのエラー・メッセージのみを表示する場合は True を指定します。

id

ID

名前をコンポーネントに割り当てます。JSP 内の固有名でなければなりません。

infoClass

再表示しない

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

infoStyle

再表示しない

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

layout

再表示しない

コンポーネントからの出力のフォーマットが、段落またはリスト・スタイルになるように指定します。
  • 段落として表示
  • リストとして表示

rendered

再表示しない

true または false に設定できます。
  • false - コンポーネントは実行時にブラウザーへのレンダリングが行われません。
  • true - コンポーネントのレンダリングが行われます。

showSummary

再表示しない

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

showDetail

再表示しない

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

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.