Render an HTML option list with
onchange action behavior that acts like a
form submit button when clicked.
See the "Decode
Behavior for UISelectOne Components" section as well as for
"Decode
Behavior for UICommand Components".
Obtain the Map
from the "requestParameterMap"
property of the ExternalContext
.
If the value in theMap
for the value of the "clientId" property of the
component is null
, create a String by concatenating
the value of the "clientId" property of the component with the
String ".x" (without the quotes). Create another String in the
same manner, but concatenate ".y" (without the quotes). Ifnull
is the value in the Map
for both
Strings, return from decode()
. If the value in theMap
for the value of the "clientId" property of the
component is not null
, get the value of the "type"
attribute, and convert it to lower case. If the result is equal
to the String "reset" (without the quotes), return fromdecode()
. Otherwise, create ajavax.faces.event.ActionEvent
around the component,
and pass it to the queueEvent()
method of the
component, which must be an instance ofUICommand
.
Attributes |
Name | Required | Request-time | Type | Description |
converter | false | false | java.lang.String |
Converter instance registered with this component.
|
id | false | false | java.lang.String |
The component identifier for this component. This value must be
unique within the closest parent component that is a naming
container.
|
immediate | false | false | java.lang.String |
Flag indicating that this component's value must be
converted and validated immediately (that is, during
Apply Request Values phase), rather than waiting
until Process Validations phase.
|
rendered | false | false | java.lang.String |
Flag indicating whether or not this component should be rendered
(during Render Response Phase), or processed on any subsequent
form submit.
|
actionListener | false | false | java.lang.String |
MethodBinding representing an action listener method that will be
notified when this component is activated by the user. The
expression must evaluate to a public method that takes an
ActionEvent parameter, with a return type of void.
|
required | false | false | java.lang.String |
Flag indicating that the user is required to provide a submitted
value for this input component.
|
validator | false | false | java.lang.String |
MethodBinding representing a validator method that will be called
during Process Validations to perform correctness checks on the
value of this component. The expression must evaluate to a public
method that takes FacesContext, UIComponent, and Object parameters,
with a return type of void.
|
value | false | false | java.lang.String |
The current value of this component.
|
valueChangeListener | false | false | java.lang.String |
MethodBinding representing a value change listener method that will be
notified when a new value has been set for this input component. The
expression must evaluate to a public method that takes a
ValueChangeEvent parameter, with a return type of void.
|
accesskey | false | false | java.lang.String |
Access key that, when pressed, transfers focus
to this element.
|
dir | false | false | java.lang.String |
Direction indication for text that does not inherit directionality.
Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).
|
disabled | false | false | java.lang.String |
Flag indicating that this element must never
receive focus or be included in a subsequent
submit.
|
disabledClass | false | false | java.lang.String |
CSS style class to apply to the rendered label
on disabled options.
|
enabledClass | false | false | java.lang.String |
CSS style class to apply to the rendered label
on enabled options.
|
lang | false | false | java.lang.String |
Code describing the language used in the generated markup
for this component.
|
onblur | false | false | java.lang.String |
Javascript code executed when this element loses focus.
|
onchange | false | false | java.lang.String |
Javascript code executed when this element loses focus
and its value has been modified since gaining focus.
|
onclick | false | false | java.lang.String |
Javascript code executed when a pointer button is
clicked over this element.
|
ondblclick | false | false | java.lang.String |
Javascript code executed when a pointer button is
double clicked over this element.
|
onfocus | false | false | java.lang.String |
Javascript code executed when this element receives focus.
|
onkeydown | false | false | java.lang.String |
Javascript code executed when a key is
pressed down over this element.
|
onkeypress | false | false | java.lang.String |
Javascript code executed when a key is
pressed and released over this element.
|
onkeyup | false | false | java.lang.String |
Javascript code executed when a key is
released over this element.
|
onmousedown | false | false | java.lang.String |
Javascript code executed when a pointer button is
pressed down over this element.
|
onmousemove | false | false | java.lang.String |
Javascript code executed when a pointer button is
moved within this element.
|
onmouseout | false | false | java.lang.String |
Javascript code executed when a pointer button is
moved away from this element.
|
onmouseover | false | false | java.lang.String |
Javascript code executed when a pointer button is
moved onto this element.
|
onmouseup | false | false | java.lang.String |
Javascript code executed when a pointer button is
released over this element.
|
onselect | false | false | java.lang.String |
Javascript code executed when text within this
element is selected by the user.
|
readonly | false | false | java.lang.String |
Flag indicating that this component will prohibit
changes by the user. The element may receive focus
unless it has also been disabled.
|
style | false | false | java.lang.String |
CSS style(s) to be applied when this component is rendered.
|
styleClass | false | false | java.lang.String |
Space-separated list of CSS style class(es) to be applied when
this element is rendered. This value must be passed through
as the "class" attribute on generated markup.
|
tabindex | false | false | java.lang.String |
Position of this element in the tabbing order
for the current document. This value must be
an integer between 0 and 32767.
|
title | false | false | java.lang.String |
Advisory title information about markup elements generated
for this component.
|
binding | false | false | java.lang.String |
The value binding expression linking this component to a property in a backing bean
|