selectOneChoice (Tobago Core Tag library documentation)

Overview

Library

Tag

Help

FRAMES NO FRAMES

tc
Tag selectOneChoice

Render a single selection dropdown list.

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

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 Class	org.apache.myfaces.tobago.internal.taglib.SelectOneChoiceTag
TagExtraInfo Class	None
Body Content	JSP
Display Name	None

Attributes
Name	Required	Request-time	Type	Description
allowClear	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating that this select provides support for clearable selections. This is a select2 feature and will force select2=true Type: `boolean` Default: `false`
allowCustom	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating that this select enables free text responses. This is a select2 feature and will force select2=true Type: `boolean` Default: `false`
binding	false	false	`javax.el.ValueExpression` (must evaluate to `javax.faces.component.UIComponent`)	The 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. Type: `javax.faces.component.UIComponent`
converter	false	false	`javax.el.ValueExpression` (must evaluate to `javax.faces.convert.Converter`)	An 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: `javax.faces.convert.Converter`
converterMessage	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	An expression that specifies the converter message Type: `java.lang.String`
disabled	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating that this element is disabled. Type: `boolean` Default: `false`
focus	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating this component should receive the focus. Type: `boolean` Default: `false`
id	false	true	`java.lang.String`	The component identifier for this component. This value must be unique within the closest parent component that is a naming container. Type: `java.lang.String`
label	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Text value to display as label. If text contains an underscore the next character is used as accesskey (if configured so and possible). Type: `java.lang.String`
markup	false	false	`javax.el.ValueExpression` (must evaluate to `org.apache.myfaces.tobago.context.Markup`)	Indicate markup of this component. The allowed markups can be defined or overridden in the theme. The value 'none' should not be used any longer. Just leave the attribute empty, or use a NULL pointer. Type: `org.apache.myfaces.tobago.context.Markup`
matcher	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	JavaScript callback to handle custom search matching This is a select2 feature and will force select2=true Type: `java.lang.String`
maximumInputLength	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	Maximum number of characters that may be provided for a search term. This is a select2 feature and will force select2=true Type: `int` Default: `0`
maximumSelectionLength	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	The maximum number of items that may be selected in a multi-select control. If the value of this option is less than 1, the number of selected items will not be limited. This is a select2 feature and will force select2=true Type: `int` Default: `0`
minimumInputLength	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	Minimum number of characters required to start a search. This is a select2 feature and will force select2=true Type: `int` Default: `0`
minimumResultsForSearch	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	The minimum number of results required to display the search box. This is a select2 feature and will force select2=true Type: `int` Default: `20`
onchange	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	** @deprecated. Will be removed in a future version ** Client side script function to add to this component's onchange handler. Client side script function to add to this component's onchange handler. Type: `java.lang.String`
placeholder	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Displays a short text in the input field, that describes the meaning of this field. This is part of HTML 5, the theme should emulate the behaviour, when the browser doesn't support it. This is a select2 feature and will force select2=true Type: `java.lang.String`
readonly	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating that this component will prohibit changes by the user. Type: `boolean` Default: `false`
rendered	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. Type: `boolean` Default: `true`
required	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating that selecting an Item representing a value is required. If an SelectItem was chosen which underling value is an empty string an ValidationError occurs and a Error Message is rendered. Type: `boolean` Default: `false`
requiredMessage	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	An expression that specifies the required message Type: `java.lang.String`
select2	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`)	Flag indicating that this element is rendered as select2. Type: `boolean` Default: `false`
tabIndex	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Integer`)	Controls 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.Integer`
tip	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	Text value to display as tooltip. Type: `java.lang.String`
validator	false	false	`javax.el.MethodExpression` (signature must match `void validator(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object)`)	A method binding EL expression, accepting FacesContext, UIComponent, and Object parameters, and returning void, that validates the component's local value.
validatorMessage	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.String`)	An expression that specifies the validator message Type: `java.lang.String`
value	false	false	`javax.el.ValueExpression` (must evaluate to `java.lang.Object`)	The current value of this component. Type: `java.lang.Object`
valueChangeListener	false	false	`javax.el.MethodExpression` (signature must match `void valueChangeListener(javax.faces.event.ValueChangeEvent)`)	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.

Variables
No Variables Defined.

Overview

Library

Tag

Help

FRAMES NO FRAMES

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.

tc Tag selectOneChoice

tc
Tag selectOneChoice