|
12. JSF HTML Tag Reference
Documentation
>
JSF
>
JSF Tag Reference
>
JSF HTML Tag Library
>
h:selectManyListbox
h:selectManyListbox |
|
The SelectManyListbox tag renders an HTML "select" list of any size with the
"multiple" attribute present. This component is designed for situations where
you want to display a list of options to the user that are not mutually
exclusive, such as a list of subscription choices, within a multiple-select list
element. The main difference between select lists and menus in JSF is the "size"
attribute. Menus always have a size of one, while lists can have a variable
size.
JSF Example
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:h="http://java.sun.com/jsf/html">
<h:head />
<body>
<h:form>
<h:selectManyListbox id="subscriptions"
value="#{subscriptionController.subscriptions}">
<f:selectItem id="item1" itemLabel="News" itemValue="1" />
<f:selectItem id="item2" itemLabel="Sports" itemValue="2" />
<f:selectItem id="item3" itemLabel="Music" itemValue="3" />
<f:selectItem id="item4" itemLabel="Java" itemValue="4" />
<f:selectItem id="item5" itemLabel="Web" itemValue="5" />
</h:selectManyListbox>
</h:form>
</body>
</html>
This example was formatted by JSFToolbox for Dreamweaver.
Rendered Output
|
Tag Attributes
| accesskey |
Text
|
| |
| The accesskey attribute is a standard HTML attribute that sets the access key
that transfers focus to this element when pressed.
|
| binding |
Expression
|
| |
| The value-binding expression linking this component tag to a backing bean
property.
|
| collectionType |
Text
|
| |
| Optional attribute that is a literal string
that is the fully qualified class name of a concrete class that implements java.
util. Collection, or an EL expression that evaluates to either 1. such a String,
or 2. the Class object itself.
|
| converter |
Text
|
| |
| The converter attribute sets the converter instance to be registered for this
component. It must match the converter-id value of a converter element defined
in your Faces configuration file.
|
| converterMessage |
Text
|
| |
| A ValueExpression enabled attribute that, if present, will be used as the
text of the converter message, replacing any message that comes from the
converter.
|
| dir |
Enumerated
|
| |
| The dir attribute is a standard HTML attribute that overrides the default
text directionality for this component. The values accepted for this component
are "LTR" (left-to-right) and "RTL" (right-to-left).
This attribute accepts the following values:
|
| disabled |
Boolean
|
| |
| The disabled attribute is a boolean flag that when set to true indicates that
this component should not receive focus or be included in a form submit.
|
| disabledClass |
Text
|
| |
| The disabledClass attribute sets the CSS style class to apply to the
component for disabled options.
|
| enabledClass |
Text
|
| |
| The enabledClass attribute sets the CSS style class to apply to the component
for enabled options.
|
| hideNoSelectionOption |
Boolean
|
| |
| Flag indicating that, if this component is
activated by the user, The "no selection option", if any, must be hidden.
|
| id |
Text
|
| |
| The unique identifier value for this component. The value must be unique
within the closest naming container.
|
| label |
Text
|
| |
| A localized user presentable name for this component.
|
| lang |
Text
|
| |
| The lang attribute is a standard HTML attribute that sets the code describing
the language to be used in the markup generated by this component.
|
| onblur |
Text
|
| |
| The onblur attribute sets the JavaScript code to execute when this element
loses focus.
|
| onchange |
Text
|
| |
| The onchange attribute sets the JavaScript code to execute when this element
loses focus and its value changes after gaining focus.
|
| onclick |
Text
|
| |
| The onclick attribute sets the JavaScript code to execute when the mouse
pointer is clicked over this element.
|
| ondblclick |
Text
|
| |
| The ondblclick attribute sets the JavaScript code to execute when the mouse
pointer is double-clicked over this element.
|
| onfocus |
Text
|
| |
| The onfocus attribute sets the JavaScript code to execute when the element
receives focus.
|
| onkeydown |
Text
|
| |
| The onkeydown attribute sets the JavaScript code to execute when a key is
pressed down over this element.
|
| onkeypress |
Text
|
| |
| The onkeypress attribute sets the JavaScript code to execute when a key is
pressed and released over this element.
|
| onkeyup |
Text
|
| |
| The onkeyup attribute sets the JavaScript code to execute when a key is
released over this element.
|
| onmousedown |
Text
|
| |
| The onmousedown attribute sets the JavaScript code to execute when the mouse
pointer is pressed down over this element.
|
| onmousemove |
Text
|
| |
| The onmousemove attribute sets the JavaScript code to execute when the mouse
pointer is moved within this element.
|
| onmouseout |
Text
|
| |
| The onmouseout attribute sets the JavaScript code to execute when the mouse
pointer is moved away from this element.
|
| onmouseover |
Text
|
| |
| The onmouseover attribute sets the JavaScript code to execute when the mouse
pointer is moved onto this element.
|
| onmouseup |
Text
|
| |
| The onmouseup attribute sets the JavaScript code to execute when the mouse
button is released over this element.
|
| onselect |
Text
|
| |
| The onselect attribute sets the JavaScript code to execute when the user
selects the text contained by this element.
|
| readonly |
Boolean
|
| |
| The readonly attribute is a boolean flag that when set to true prohibits
changes to this element by the user. The element will continue to receive focus
unless you set the disabled attribute to true.
|
| rendered |
Boolean
|
| |
| A value-binding expression that evaluates to a Boolean condition indicating
if this component should be rendered.
|
| required |
Boolean
|
| |
| The required attribute is a boolean flag that indicates whether or not the
user is required to provide a value for this field before the form can be
submitted to the server.
|
| requiredMessage |
Text
|
| |
| A ValueExpression enabled attribute that, if present, will be used as the
text of the validation message for the "required" facility, if the "required"
facility is used.
|
| size |
Text
|
| |
| The size attribute sets the width in characters of this input field.
|
| style |
Text
|
| |
| The style attribute sets the CSS style definition to be applied to this
component when it is rendered.
|
| styleClass |
Text
|
| |
| The styleClass attribute sets the CSS class to apply to this component when
it is rendered.
|
| tabindex |
Text
|
| |
| The tabindex attribute is a standard HTML attribute that sets the order in
which this element receives focus when the user cycles through the elements
using the TAB key. The value for this attribute must be an integer between 0 and
32767.
|
| title |
Text
|
| |
| The title attribute is a standard HTML attribute that sets the tooltip text
to display for the rendered component.
|
| validator |
Text
|
| |
| The validator attribute accepts a method-binding expression representing a
validator method that will be called when the JSF framework validates this
component. A validator method must be a public method that takes FacesContext,
UIComponent, and Object parameters, with a return type of void.
|
| validatorMessage |
Text
|
| |
| A ValueExpression enabled attribute that, if present, will be used as the
text of the validator message, replacing any message that comes from the
validator.
|
| value |
Text
|
| |
| The value attribute sets the current value for this component.
|
| valueChangeListener |
Text
|
| |
| The valueChangeListener attribute accepts a method-binding expression
representing a value change listener method to be notified when a new value has
been set for this input component. A value change listener method must be a
public method that takes a ValueChangeEvent parameter, with a return type of
void.
|
|
|
|
|
|
