comboBox - Zone de liste déroulante

Affiche une liste d'éléments dont un seul peut être sélectionné à la fois.

Catégorie

Contrôles principaux

Syntaxe

<xp:comboBox attributes>content</xp:comboBox>

Tableau 1. Contrôles imbriqués
Commande	Description
selectItem	Fournit un élément pour une sélection utilisateur.
selectItems	Fournit un ou plusieurs éléments pour une sélection utilisateur.

Tableau 2. Propriétés essentielles
Propriété	Description
id	Prend par défaut les valeurs `comboBox1`, `comboBox2`, etc.
text	Fournit un libellé.
value	Lie le contrôle à un élément de données ou à une autre valeur.

Tableau 3. Toutes les propriétés
Catégorie	Propriétés
accessibilité	accesskey, role, tabindex, title
fondamentaux	attrs, binding, dir, disabled, id, immediate, lang, loaded, readonly, rendered, rendererType, required
données	converter, Valeurdéfaut, disableClientSideValidation, disableModifiedFlag, disableValidators, showReadonlyAsDisabled, validator, validators, value, valueChangeListener, valueChangeListeners
dojo	dojoAttributes, dojoType
événements	onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup
définition de style	disabledClass, disableTheme, enabledClass, style, styleClass, themeId

Utilisation

A l'exécution, une liste déroulante apparaît sur la page dans laquelle l'utilisateur peut sélectionner un élément.

Exemples

Ce contrôle Zone de liste déroulante présente deux éléments pour sélection.

<xp:comboBox id="comboBox1" value="#{document1.fruit}">
	<xp:selectItem itemLabel="Apples" itemValue="apples"></xp:selectItem>
	<xp:selectItem itemLabel="Oranges" itemValue="oranges"></xp:selectItem>
</xp:comboBox>

Ce contrôle Zone de liste déroulante présente deux éléments pour sélection en utilisant une formule.

<xp:comboBox id="comboBox1" value="#{document1.fruit}">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:return new Array("Apples|apples", "Oranges|oranges")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:comboBox>

Cette zone de liste déroulante obtient ses sélections d'éléments à partir des valeurs d'une colonne de vue.

<xp:comboBox id="comboBox1" value="#{document1.fruit}">
	<xp:selectItems>
		<xp:this.value>
			<![CDATA[#{javascript:var list = @DbColumn("", "fruits", 1);
			return @Explode(list,",")}]]>
		</xp:this.value>
	</xp:selectItems>
</xp:comboBox>