Trinidad Core Tag Reference - Select Many Listbox

Documentation

Search

	1.	Introduction
	2.	Getting Started
	3.	Trinidad Concepts
	4.	Code View Support
	5.	Design View Support
	6.	Tag Object Toolbars
	7.	Server Behaviors
	8.	Property Inspectors
	9.	Trinidad Tag Reference

10. Trinidad Core Tag Reference

Contents > Trinidad Core Tag Reference > tr:selectManyListbox

tr:selectManyListbox

The tr:selectManyListbox tag displays a list in a text box and allows the user to select many items in the list.

Example

<tr:selectManyListbox label="Favourite Fruit" size="4" required="#{true}" showRequired="#{true}">
  <f:selectItem itemLabel="Apple" itemValue="1" />
  <f:selectItem itemLabel="Orange" itemValue="2" />
  <f:selectItem itemLabel="Banana" itemValue="3" />
  <f:selectItem itemLabel="Grape" itemValue="4" />
  <f:selectItem itemLabel="Pear" itemValue="5" /> 
        <f:facet name="help">
    <tr:outputText value="Please select" />
  </f:facet>               
</tr:selectManyListbox>

Rendered Output

Tag Attributes

accessKey	Text

The accessKey attribute sets one character from the text on the component to use as a quick access key.

attributeChangeListener	Text

The attributeChangeListener attribute contains the reference to a method that is invoked when the renderer changes a property without the application’s request.

autoSubmit	Text

The autoSubmit attribute determines if the form will be automatically submitted to the server when the user enters a value.

binding	Expression

The value-binding expression linking this component tag to a backing bean property.

contentStyle	Text

The contentStyle attribute sets the CSS styles for the input text box.

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.

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.

id	Text

The unique identifier value for this component. The value must be unique within the closest naming container.

immediate	Boolean

The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular component.

inlineStyle	Text

The inlineStyle attribute contains inline style information, such as background color.

label	Text

The label attribute sets the text that is displayed before the component.

labelAndAccessKey	Text

The labelAndAccessKey attribute ...

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.

partialTriggers	Text

The partialTriggers attribute sets the ids of components that cause a partial update. Use single colon for components that are in naming containers and multiple colons to search through parent and grandparent containers.

readOnly	Text

The readOnly attribute is a boolean flag that when set to true indicates that this component is read only.

rendered	Boolean

A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.

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.

requiredMessageDetail	Text

The requiredMessageDetail attribute sets the custom error message with the parameters {0} for a label to identify the component when the value for the component is required (the required attribute is set to “true”) and validation fails.

shortDesc	Text

The shortDesc attribute sets the text that is rendered with the component. If the simple attribute is set to "true", then the shortDesc text will be displayed instead of the label. If the simple attribute is set to "false" and not label is specified, then the shortDesc text is displayed to the right of the input text box.

showRequired	Text

The showRequired attribute is a boolean flag that when set to "true" determines if an "*" will be displayed before the component to indicate that the value is required. The attributue required must also be set to "true". The default is false.

simple	Text

The simple attribute is a boolean flag that when set to "true" renders the component without any padding for messages. If a label attribute is specified, then the label is rendered to the right of the component. The default is "false".

size	Text

The size attribute sets the width in characters of this input field.

styleClass	CSS Class

The styleClass attribute sets the CSS class to apply to this component when it is rendered.

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.

valuePassThru	Text

The valuePassThru attribute is a boolean flag that when set to "false", you do not need a converter for custom value or options objects. When set to "true", you need a custom converter for custom objects. The default is false.