|
9. Tomahawk Tag Reference
Documentation
>
Tomahawk
>
Tomahawk Tag Reference
>
Tomahawk Tag Library
> t:selectOneListbox
|
t:selectOneListbox |
|
<p>The <t:selectOneListbox> tag extends the JSF h:selectOneListbox tag. It supports conditional rendering based on user roles.</p>
Example
<t:selectOneListbox> </t:selectOneListbox>
|
Tag Attributes
| accesskey |
Text |
| |
| HTML:Sets the access key for this element.
|
| binding |
Expression |
| |
| The value-binding expression linking this component tag to a backing bean property.
|
| 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 |
| |
| Text to be displayed to the user as an error message when conversion of a
submitted value to the target type fails.
<p>
</p>
|
| datafld |
Text |
| |
| The W3C has reserved the datafld attribute for future use.
====MERGED====
The Tomahawk developers have reserved the datafld attribute for future use.
|
| datasrc |
Text |
| |
| The W3C has reserved the datasrc attribute for future use.
====MERGED====
The Tomahawk developers have reserved the datasrc attribute for future use.
|
| dir |
Text |
| |
| 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).
|
| disabled |
Text |
| |
| 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.
|
| displayValueOnly |
Text |
| |
| The displayValueOnly attribute expects a boolean value that, when set to true, causes a tag to render its value only, and not the associated UI component.
|
| displayValueOnlyStyle |
Text |
| |
| The displayValueOnlyStyle attribute defines the CSS style applied to the display value of this tag when the displayValueOnly attribute is set to true.
|
| displayValueOnlyStyleClass |
Text |
| |
| The displayValueOnlyStyleClass attribute defines the CSS class applied to the display value of this tag when the displayValueOnly attribute is set to true.
|
| enabledClass |
Text |
| |
| The enabledClass attribute sets the CSS style class to apply to the component for enabled options.
|
| enabledOnUserRole |
Text |
| |
| The enabledOnUserRole attribute determines if this component will be rendered normally or not depending on the user's roles.
|
| escape |
Text |
| |
| The escape attribute, when set to true, causes the content of this tag to be rendered as unescaped HTML. The default value is true.
|
| forceId |
Text |
| |
| The forceId attribute expects a boolean value, that when set to true, forces the tag to render its ID exactly as specified in the ID attribute. This allows you to apply CSS styles to the tag and to reference it in JavaScript by ID, which is typically not possible using the default JSF component ID naming system. This attribute is false by default.
|
| forceIdIndex |
Text |
| |
| The forceIdIndex attribute effects the component ID name when this component is rendered at runtime. It expects a boolean value that, when true, causes the component to display an index number in its ID value if the component is in a list. It has a default value of true.
|
| id |
Text |
| |
| The unique identifier value for this component. The value must be unique within the closest naming container.
|
| label |
Text |
| |
| A display 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 |
| |
| HTML:Specifies a script to be invoked when the element is selected.
|
| readonly |
Text |
| |
| 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 |
Text |
| |
| A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
|
| required |
Text |
| |
| 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 |
| |
| Text to be displayed to the user as an error message when this component is
marked as "required" but no input data is present during a postback (ie the
user left the required field blank).
|
| 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 |
| |
| Text which will be shown if validation fails.
|
| 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.
|
| visibleOnUserRole |
Text |
| |
| The visibleOnUserRole attribute determines if this component will be visible or not depending on the user's roles.
|
|
|
|
|
|