ユーザーが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
converter
id
immediate
rendered
required
validator
FacesContext
、UIComponent
およびObject
パラメータを取るpublicメソッドを評価し、戻り型がvoid
である必要があります。
value
valueChangeListener
ValueChangeEvent
パラメータを取るpublicメソッドを評価し、戻り型がvoid
である必要があります。
JSFでサポートされているHTML 4.01属性(オプション)については、「JSF標準コンポーネントのタグ属性の概要」を参照してください。
このタグおよびすべてのJSF Core要素とHTML要素の詳細は、次のURLの「W3C JavaServer Faces 1.1 Specification」を参照してください。
http://java.sun.com/j2ee/javaserverfaces/1.1/docs/tlddocs/index.html
Copyright © 1997, 2006, Oracle. All rights reserved.