JavaServer Faces

Name

SelectMany/Menu

Synopsis

This renderer represents a select-many component as a selection list drop-down menu.

Component family:	javax.faces.SelectMany
Renderer type:	javax.faces.Menu
Renders children:	No

Encode behavior

Renders the component as an HTML <select> element with a name attribute set to the component’s client ID and a multiple attribute and a size attribute with 1 as the value. Each choice represented by the component’s children (one or more UISelectItem and UISelectItems components) is rendered as an <option> element or as an <optgroup> element if the child is of the UISelectItemGroup subtype. For all choices that match one of the component’s values, the selected attribute is set for the corresponding <option> element. If a choice is marked as disabled, the disabled attribute is also added.

Decode behavior

Looks for request parameters with the component’s client ID as the name. If it finds parameters, the renderer the calls component’s setSubmittedValue() method with a String[] holding all parameter values as the value; otherwise it calls the same method with an empty String[] as the value.

Attributes

[accesskey="accessKey"] [dir="ltr|rtl"] [disabled="true|false"]
[lang="lang"] [onblur="code"] [onchange="code"] [onclick="code"]
[ondblclick="code"] [onfocus="code"] [onkeydown="code"]
[onkeypress="code"] [onkeyup="code"] [onmousedown="code"]
[onmousemove="code"] [onmouseout="code"] [onmouseover="code"]
[onmouseup="code"] [onselect="code"] [readonly="true|false"] [style=" ...