JSF HTML Tag Reference - Select Many Menu

Documentation

Search

Contents

	1.	Introduction
	2.	Getting Started
	3.	Developing Web Sites
	4.	Using Components
	5.	Internationalization
	6.	Code View Support
	7.	Design View Support
	8.	Keyboard Shortcuts
	9.	Tag Object Toolbars
	10.	JSF Server Behaviors
	11.	Property Inspectors
	12.	JSF Tag Reference

12. JSF Tag Reference

Contents > JSF Tag Reference > JSF HTML Tags

10. JSF HTML Tag Reference

Contents > JSF HTML Tag Reference > h:selectManyMenu

h:selectManyMenu

The SelectManyMenu tag renders an HTML "select" element with the "multiple" attribute present and the "size" attribute set to 1. This component is designed for situations where you want to display a list of menu items to the user that allows the selection of multiple options using a menu that displays one item at a time.

The main difference between select lists and menus in JSF is the "size" attribute. Menus always have a size of one, while lists can have a variable size.

Note: This component is not rendered consistently across the major browsers. Internet Explorer displays a set of miniaturized arrow icons that allow the user to scroll up and down the menu list, however, Netscape/Mozilla browsers do not.

Example:

<h:selectOneMenu id="subscriptions" value="#{subscriberBean.subscriptions}">
  <f:selectItem id="item1" itemLabel="News" itemValue="1" />
  <f:selectItem id="item2" itemLabel="Sports" itemValue="2" />
  <f:selectItem id="item3" itemLabel="Music" itemValue="3" />
  <f:selectItem id="item4" itemLabel="Java" itemValue="4" />
  <f:selectItem id="item5" itemLabel="Web" itemValue="5" />
</h:selectOneMenu>

HTML Output

<select id="form:menu" name="form:menu" multiple="true" size="1">
  <option value="1">News</option>
  <option value="2">Sports</option>
  <option value="3">Music</option>
  <option value="4">Java</option>
  <option value="5">Web</option>
</select>

Tag Attributes

accesskey	String

The accesskey attribute is a standard HTML attribute that sets the access key that transfers focus to this element when pressed.

binding	String

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

converter	String

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	String

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	String

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	String

The disabledClass attribute sets the CSS style class to apply to the component for disabled options.

enabledClass	String

The enabledClass attribute sets the CSS style class to apply to the component for enabled options.

id	String

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

immediate	String

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.

lang	String

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	String

The onblur attribute sets the JavaScript code to execute when this element loses focus.

onchange	String

The onchange attribute sets the JavaScript code to execute when this element loses focus and its value changes after gaining focus.

onclick	String

The onclick attribute sets the JavaScript code to execute when the mouse pointer is clicked over this element.

ondblclick	String

The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.

onfocus	String

The onfocus attribute sets the JavaScript code to execute when the element receives focus.

onkeydown	String

The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.

onkeypress	String

The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.

onkeyup	String

The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.

onmousedown	String

The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.

onmousemove	String

The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.

onmouseout	String

The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.

onmouseover	String

The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.

onmouseup	String

The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.

onselect	String

The onselect attribute sets the JavaScript code to execute when the user selects the text contained by this element.

readonly	String

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	String

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

required	String

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.

style	String

The style attribute sets the CSS style definition to be applied to this component when it is rendered.

styleClass	String

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

tabindex	String

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	String

The title attribute is a standard HTML attribute that sets the tooltip text to display for the rendered component.

validator	String

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	String

The value attribute sets the current value for this component.

valueChangeListener	String

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.