crm:selectOneMenu

Overview

The <crm:selectOneMenu> tag is used to display an element on the page that allows user to select a single item from a list.

Attributes

Name	Required	Type	Default	Description
additionalLabel	false	String	null	Additional Label of the item.
className	true	String	null	The class name of the value of the component.
columnClasses	false	String	ui-grid-col-12	Comma separated list of column style classes of the gird layout that will be used to display the component. Column style class should be prefixed with ui-grid-col- and suffixed with the number of columns that content will take (out of 12). For example, for two columns with the same size the columnClasses should be "ui-grid-col-6,ui-grid-col-6".
columns	false	Integer	1	Number of columns of the gird layout that will be used to display the component.
databaseName	false	String	null	Database name that will be used to load the data.
displayValue	true	String	null	The displayed value of the component in view mode.
emptyOptionLabel	false	String	key_select	A valid key defined in translation properties file. Its translation through the glossary will be added as empty item in the collection of available items.
filter	false	Boolean	true	Renders an input field as a filter.
id	true	String	null	Unique identifier of the component.
isRequired	false	Boolean	true if the data object property of the component is mandatory, otherwise false.	Marks component as required.
itemLabel	true	String	name	Label of the item in overlay.
labelKey	false	String	null	A valid key defined in translation properties file. Its translation through the glossary will be used as the presentable name of the component.
managedBean	true	String	null	The name of the Java managed bean class that will be used for retrieving the component values.
mandatory	false	Boolean	false	Marks component as required.
mode	false	String	The mode of the managed bean.	The mode of the component. Allowed values are VIEW and EDIT.
onChangeFunction	false	String	null	Defines the function call triggered when input element loses focus and its value has been modified since gaining focus.
onCompleteScript	false	String	null	Defines the function call triggered when on change event is completed.
optionsList	true	List	null	A collection of available items in overlay.
parameters	false	String	null	Defines additional parameter of the function call.
process	false	String	@this and the value of the refresh attribute	Component(s) to process in partial request.
readonly	false	Boolean	false	Flag indicating that this component will prevent changes by the user.
refresh	false	String	@this	Component(s) to update with ajax.
showEmptyOption	false	Boolean	true	Flag indicating that empty item should be shown in the collection of available items.
templateTooltip	false	String	null	Description of the item in overlay.
tip	false	String	null	A valid key defined in translation properties file. Its translation through the glossary will be used as an advisory tooltip information.
type	false	String	null	The type of the value of the component.
value	true	Object	null	The value of the component.
visible	false	Boolean	true	Controls the visibility of the component.

Getting Started

The following example shows a select one menu component.