JSF HTMLライブラリ - <h:selectOneListbox>タグ

ユーザーが1つのアイテムを選択できるように、一度に表示される一連のアイテムを作成します。コンポーネントは、name属性がコンポーネントのクライアントIDに設定された<select>要素としてレンダリングされます。size属性を設定すると、指定した値のままで<select>要素に追加されます。設定しないと、size属性は選択肢の数を値として要素に追加されます。コンポーネントの子、つまり1つ以上のUISelectItemコンポーネントとUISelectItemsコンポーネントによって表される各選択肢は、<option>要素としてレンダリングされます。コンポーネントのいずれかの値に一致するすべての選択肢について、対応する<option>要素のselected属性が設定されます。また、選択肢が無効とマークされると、disabled属性が追加されます。

構文

<h:selectOneListbox value="value"
	[id="id"]
	[binding="componentBinding"]
	[rendered="true|false"]
	[converter="converter"]
	[required="true|false"]
	[validator="validatorMethod"]
	[valueChangeListener="listenerMethod"]
	[immediate="true|false"]
<!--HTML attributes-->
>
	<f:selectItem> and/or <f:selectItems> action components
/h:selectOneListbox>

属性

binding
文字列。このコンポーネントをバッキングBeanのプロパティにリンクする値バインディング式。
converter
文字列。このコンポーネントに登録されたコンバータ・インスタンス。
id
文字列。このコンポーネントのコンポーネント識別子。値は、ネーミング・コンテナである最も近い親コンポーネント内で一意である必要があります。
immediate
ブール値。このコンポーネントの値は、検証処理フェーズまで待機するのではなく、リクエストの適用フェーズ中に変換および検証される必要があることを示すフラグ。
rendered
ブール値。レンダー・レスポンス・フェーズ中にこのコンポーネントをレンダリングするかどうか、または後続のフォーム発行でこのコンポーネントを処理するかどうかを示すフラグ。
required
ブール値。ユーザーがこの入力コンポーネントに対して発行済の値を指定する必要があるかどうかを示すフラグ。
validator
文字列。検証処理フェーズ中にコールされるバリデータ・メソッドを表すMethodBinding。検証処理フェーズでは、このコンポーネントの値の正確性チェックが実行されます。式では、FacesContextUIComponentおよびObjectパラメータを取るpublicメソッドを評価し、戻り型がvoidである必要があります。
value
オブジェクト。このコンポーネントの現在の値。
valueChangeListener
文字列。この入力コンポーネントに対して新規の値が設定されると通知を受け取る値変更リスナー・メソッドを表すMethodBinding。式では、ValueChangeEventパラメータを取るpublicメソッドを評価し、戻り型がvoidである必要があります。

JSFでサポートされているHTML 4.01属性(オプション)については、「JSF標準コンポーネントのタグ属性の概要」を参照してください。

このタグおよびすべてのJSFコア要素とHTML要素の詳細は、次のURLの「W3C JavaServer Faces 1.1 Specification」を参照してください。
http://java.sun.com/j2ee/javaserverfaces/1.1/docs/tlddocs/index.html


リファレンス: JSF標準コンポーネント