出力 - フォーマット済みテキスト

フォーマットされたメッセージをページに出力します。このメッセージは、 データ・ストレージ (データベースなど) や Bean から作られる 静的テキストと動的データの組み合わせとして定義されます。

設計時のコンポーネント

「出力 - フォーマット済みテキスト」コンポーネントを、 ページ上にドラッグ・アンド・ドロップします。

「出力 - フォーマット済みテキスト」コンポーネントのボタン

「出力 - フォーマット済みテキスト」コンポーネントは、 ページ上ではこのように表示されます。

設計時の「出力 - フォーマット済みテキスト」

実行時のコンポーネント

実行時の「出力 - フォーマット済みテキスト」コンポーネントは、 ページ上ではこのように表示されます。

実行時の「出力 - フォーマット済みテキスト」

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

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

イメージ・コンポーネントの共通属性は、 「プロパティー」ビューの「h:outputFormat」タブに表示されます。 属性の完全なリストについては、「出力 - フォーマット済みテキスト」のすべての属性 の 表を参照してください。 パラメーターの追加に関する追加の構成オプションは、 「h:outputFormat」タブにあります。

表 1. 「出力 - フォーマット済みテキスト」の構成オプション

構成オプション

説明

値ストリング内の各 {n} を置換するためのパラメーター値を追加する

出力メッセージ・パラメーターの名前および値を 指定することができます。「除去」ボタンを使用して項目を除去したり、 「上へ移動」ボタンと「下へ移動」ボタンとを使用して、 パネル内での順序を変更したりすることもできます。

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

表 2. 「出力 - フォーマット済みテキスト」のすべての属性

属性名

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

説明

binding

非表示

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

converter

非表示

値の変換後のデータ型を指定します。 JavaServer Faces の実装によって、 コンポーネント・データをレンダラーがサポートしない型に変換する際に使用できる、 コンバーターの実装セットが提供されます。

escape

非表示

HTML のフォーマットを エスケープするか (False)、HTML タグを HTML として レンダリングするか (True) を指定します。

id

ID

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

immediate

非表示

true にすると、ライフ・サイクルのレンダリング・フェーズまでスキップします。

rendered

非表示

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

style

スタイル: プロパティー

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

styleClass

スタイル: クラス

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

title

非表示

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

value

実行時に表示されるコンポーネントの初期テキスト値を指定します。 表示される情報が、指定された値または動的な値のポインターのフォームで組み込まれます。

関連資料
出力

フィードバック