ユーザーが複数のアイテムを選択できるように、一度に表示される一連のアイテムを作成します。コンポーネントは、name
属性がコンポーネントのクライアントIDに設定されてmultiple
属性を持つ<select>
要素としてレンダリングされます。size属性を設定すると、指定した値のままで<select>要素に追加されます。設定しないと、size属性は選択肢の数を値として要素に追加されます。コンポーネントの子、つまり1つ以上のUISelectItem
コンポーネントとUISelectItems
コンポーネントによって表される各選択肢は、<option>
要素としてレンダリングされます。コンポーネントのいずれかの値に一致するすべての選択肢について、対応する<option>
要素のselected
属性が設定されます。また、選択肢が無効とマークされると、disabled
属性が追加されます。
<h:selectManyListbox 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:selectManyListbox>
binding
converter
id
immediate
rendered
required
validator
FacesContext
、UIComponent
およびObject
パラメータを取るpublicメソッドを評価し、戻り型がvoid
である必要があります。
value
valueChangeListener
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
Copyright © 1997, 2009, Oracle. All rights reserved.