| |
|
|
|
 |
Home NewsProducts Download Buy Now Documentation Support |
 |
 |
|
|
 |
| |
Contents
|
10. ICEfaces Tag Reference
Contents > ICEfaces Tag Reference > ice:selectInputText
ice:selectInputText |
|
The ice:selectInputText tag provides an inputText component enhanced with auto-complete functionality. As the user enters text into the component it provides a popup list of possible matching values from which the user may select. The component predicts a word or phrase that a user wants to type in without the user actually completely typing it in. The selectInputText component requires developers to implement the matching list search algorithm in their backing bean.
The selectInputText component can generate one of two types of lists:
1. A list of String data.
2. A list of arbitrarily complex child components.
Example
<ice:selectInputText size="120" />
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. |
| action |
Text |
| |
| The action attribute accepts a method-binding expression for a backing bean action method to invoke when this component is activated by the user. An action method must be a public method with no parameters that returns a String. The returned string represents the logical outcome of the action (eg. "success", "failure", etc.) and is used by the JavaServer Faces MVC framework to determine which view to display next. |
| actionListener |
Text |
| |
| The actionListener attribute accepts a method-binding expression for a backing bean action listener method that will be notified when this component is activated by the user. An action listener method must be a public method with an javax.faces.event.ActionEvent parameter and a void return type. |
| alt |
Text |
| |
| The alt attribute is a standard HTML attribute that sets the alternate textual description rendered by this component. |
| autocomplete |
Text |
| |
| The autocomplete attribute is a boolean flag that when set to "true" passes through to the root 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. |
| 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). |
| 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. |
| effect |
Text |
| |
| The effect attribute sets the JavaScript effect.
|
| enabledOnUserRole |
Text |
| |
| The enabledOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed and will function. If the user does not have a role, then the component will be disabled (will not function) and will be grayed out. |
| id |
Text |
| |
| The unique identifier value for this component. The value must be unique within the closest naming container. |
| 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. |
| listValue |
Text |
| |
| The listValue attribute sets the list of selectItem components. |
| listVar |
Text |
| |
| The listVar attribute sets the name of a request-scope attribute under which the model data for the row selected by the current value of the "rowIndex" property (i.e. also the current value of the "rowData" property) will be exposed. |
| maxlength |
Text |
| |
| The maxlength attribute sets the maximum length in characters of the string accepted by this input 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. |
| onclickeffect |
Text |
| |
| The onclickeffect attribute sets the effect to invoke when 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. |
| ondblclickeffect |
Text |
| |
| The ondblclickeffect attribute sets the effect to invoke 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. |
| onkeydowneffect |
Text |
| |
| The onkeydowneffect attribute sets the effect to invoke 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. |
| onkeypresseffect |
Text |
| |
| The onkeypresseffect attribute sets the effect to invoke 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. |
| onkeyupeffect |
Text |
| |
| The onkeyupeffect attribute sets the effect to invoke 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. |
| onmousedowneffect |
Text |
| |
| The onmousedowneffect attribute sets the effect to invoke 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. |
| onmousemoveeffect |
Text |
| |
| The onmousemoveeffect attribute sets the effect to invoke 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. |
| onmouseouteffect |
Text |
| |
| The onmouseouteffect attribute sets the effect to invoke 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. |
| onmouseovereffect |
Text |
| |
| The onmouseovereffect attribute sets the effect to invoke 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. |
| onmouseupeffect |
Text |
| |
| The onmouseupeffect attribute sets the effect to invoke 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. |
| partialSubmit |
Boolean |
| |
| The partialSubmit attribute is a boolean flag that when set to "true" will allow the component to activate a partial submit of the form. |
| 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. |
| renderedOnUserRole |
Text |
| |
| The renderedOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed. If the user does not have a role, then the component will not be displayed. |
| 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. |
| rows |
Text |
| |
| The rows attribute sets the number of rows to display, starting from the row identified by the "first" attribute. If the value of the rows attribute is set to zero, all available rows in the underlying data model will be displayed. |
| size |
Text |
| |
| The size attribute sets the width in characters of this input field. |
| style |
CSS Style |
| |
| The style attribute sets the CSS style definition to be applied to this component when it is rendered. |
| styleClass |
CSS Class |
| |
| 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. |
| 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. |
| visible |
Boolean |
| |
| The visible attribute is a boolean flag that when set to "true", displays the component. If this attribute is set to "false", then the CSS style is display:none. |
| width |
Text |
| |
| The width attribute ... |
|
|
|
| |
|