ListTag

A list tag references a DataCollection in the context hierarchy and creates a selectable HTML element populated with the inner elements of the collection.

Mandatory attributes: dataNameForList, dataName

Table 1. ListTag attributes
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>