djFilteringSelect - Dojo Filtering Select

Accepts a selected and filtered value.

Category

Dojo Form

Syntax

<xe:djFilteringSelect attributes>content</xe:djFilteringSelect>
Table 1. Essential properties
Property Description
id Defaults to djFilteringSelect1, djFilteringSelect2, and so on.
value Binds the control to a data element.

Usage

This is a Dojo control.

At run time, a dropdown box appears on the page presenting itemLabel choices and returning the itemValue that corresponds to the selected itemLabel. Use embedded selectItem controls or an embedded selectItems control to specify the pairs of labels and values.

This control is not tested against the latest accessibility standards. The recommended accessible path is the Combo Box control.

Examples

This example consists of a Filtering Select box bound to a scoped variable, a button for submitting the page, and a computed field that displays the value of the scoped variable. The text box presents the itemLabel choices to the user and takes the itemValue of the selected itemLabel.
<xp:table>
	<xp:tr>
		<xp:td>Filtering Select</xp:td>
		<xp:td>
		<xe:djFilteringSelect id="djFilteringSelect1" value="#{sessionScope.djFilteringSelect1}">
		<xp:selectItem itemLabel="Maine" itemValue="ME"></xp:selectItem>
		<xp:selectItem itemLabel="New Hampshire" itemValue="NH"></xp:selectItem>
		<xp:selectItem itemLabel="Vermont" itemValue="VT"></xp:selectItem>
		<xp:selectItem itemLabel="Massachusetts" itemValue="MA"></xp:selectItem>
		<xp:selectItem itemLabel="Rhode Island" itemValue="RI"></xp:selectItem>
		<xp:selectItem itemLabel="Connecticut" itemValue="CT"></xp:selectItem>
		</xe:djFilteringSelect></xp:td>
	</xp:tr>
	<xp:tr>
		<xp:td>
			<xp:button value="submit" id="button1">
				<xp:eventHandler event="onclick" submit="true" refreshMode="complete" immediate="false" save="true">
			</xp:eventHandler></xp:button>
		</xp:td>
		<xp:td></xp:td>
	</xp:tr>
	<xp:tr>
		<xp:td>Value</xp:td>
		<xp:td><xp:text escape="true" id="computedField1" value="#{sessionScope.djFilteringSelect1}"></xp:text></xp:td>
	</xp:tr>
</xp:table>