Mandatory attributes: dataNameForList, dataName
Attribute | Description | Default value |
---|---|---|
dataNameForList | ID of the DataCollection. If the DataCollection is a KeyedCollection, each inner DataField corresponds to an option element. The combo box uses the field ID as the option label and the field value as the option value. If the DataCollection is an IndexedCollection, the inner elements must be KeyedCollections, and the item and value attributes are mandatory. Each inner KeyedCollection corresponds to an option element. The list uses the collection field named in the item attribute as the label and uses the collection field named in the value attribute as the option value. If the data element named dataName contains the value of an option element, the combo box highlights this option element as selected (it is the default). | |
dataName | Name of the DataField in the context hierarchy. If the DataField is read only, in Internet Explorer the combo box is also read only. If a form containing a list is submitted, the context's element named dataName is set with the list's value (either a String or a String[] depending on how many option elements the user selected.) | |
multipleSelection | Whether the user can select more than one option | no |
item | Collection field to use as the option label | null |
value | Collection field to use as the option value | null |
size | Maximum number of items that the user can select | null |
style | Style for the list | null |
custom | Adds attributes to the input element. The following is the format of this attribute: custom="att1Name=\"att1Value\ "att2Name=\"att2Value\"..." | null |
The following is an example of using list tag:
<H1>Using the List Tag</H1> <dse:form name="f1" nextEventName="ok"><br> <table border="1"><tr><td> <dse:list dataName="selectedMaritalStatus4" dataNameForList="availableMaritalStatus" size="2"/></td><td> <dse:list dataName="selectedSports2" dataNameForList="availableFavoriteSports" multipleSelection="yes"/> </td></tr><tr><td> <dse:list dataName="selectedPreferredPhone3" dataNameForList="phonesList" item="name" value="type"/></td><td> <dse:list dataName="selectedAccounts3" dataNameForList="accountsList" item="name" value="number" multipleSelection="yes" size="4"/> </td></tr></table> </dse:form>