Tobago Components
Tag selectOneChoice


Render a single selection dropdown list.

UIComponentClass: org.apache.myfaces.tobago.component.UISelectOne

RendererType: SelectOneChoice

Supported facets:

click
This facet can contain a UICommand that is invoked in case of a click event from the component
change
This facet can contain a UICommand that is invoked in case of a change event from the component


Tag Information
Tag Classorg.apache.myfaces.tobago.taglib.component.SelectOneChoiceTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
validatorfalsetruejava.lang.StringA method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.
Type: javax.faces.el.MethodBinding
onchangefalsetruejava.lang.StringClientside script function to add to this component's onchange handler.
Type: java.lang.String
valuefalsetruejava.lang.StringThe current value of this component.
Type: java.lang.Object
valueChangeListenerfalsetruejava.lang.StringMethodBinding 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.
Type: javax.faces.el.MethodBinding
tabIndexfalsetruejava.lang.StringControls the navigation of the focus through the input controls on a page with the Tab-Key. The navigation starts from the element with the lowest tabIndex value to the element with the highest value. Elements that have identical tabIndex values should be navigated in the order they appear in the character stream Elements that are disabled or with a negative tabIndex do not participate in the tabbing order.
Type: java.lang.String
focusfalsetruejava.lang.StringFlag indicating this component should recieve the focus.
Type: java.lang.Boolean
markupfalsetruejava.lang.StringIndicate markup of this component. Possible value is 'none'. But this can be overridden in the theme.
Type: java.lang.String
Default: none
idfalsetruejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
Type: java.lang.String
disabledfalsetruejava.lang.StringFlag indicating that this element is disabled.
Type: java.lang.Boolean
readonlyfalsetruejava.lang.StringFlag indicating that this component will prohibit changes by the user.
Type: java.lang.Boolean
inlinefalsetruejava.lang.StringFlag indicating this component should rendered as an inline element.
Type: java.lang.Boolean
labelfalsetruejava.lang.String

**** @deprecated. Will be removed in a future version ****

Text value to display as label. If text contains an underscore the next character is used as accesskey.
Type: java.lang.String
accessKeyfalsetruejava.lang.String

**** @deprecated. Will be removed in a future version ****

Deprecated! Has not longer any function. See label attribute.
Type: [java.lang.String, java.lang.Character]
labelWithAccessKeyfalsetruejava.lang.String

**** @deprecated. Will be removed in a future version ****

Deprecated! Use 'label' instead. Text value to display as label. If text contains an underscore the next character overwrites 'accesskey'.
Type: java.lang.String
renderedfalsetruejava.lang.StringFlag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
Type: java.lang.Boolean
Default: true
converterfalsetruejava.lang.StringAn expression that specifies the Converter for this component. If the value binding expression is a String, the String is used as an ID to look up a Converter. If the value binding expression is a Converter, uses that instance as the converter. The value can either be a static value (ID case only) or an EL expression.
Type: java.lang.String
bindingfalsetruejava.lang.StringThe value binding expression linking this component to a property in a backing bean.

Warning: For the tobago extension library tx the binding differs from JSP and Facelets:

  • JSP: The component is the inner main control (e. g. UIInput).
  • Facelets: The component is the outer UIPanel.
tipfalsetruejava.lang.StringText value to display as tooltip.
Type: java.lang.String
requiredfalsetruejava.lang.StringFlag indicating that selecting an Item representing a value is required. If an SelectItem was choosen which underling value is an empty string an ValidationError occurs and a Error Message is rendered.
Type: java.lang.Boolean

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.