


	UP \| PREV \| NEXT


X-Application
Tag Preview

Reference Information for the <select> tag

Parameter	Required	Values
text	true	specifies an X-Query expression for the field that represents the externally displayed value for the HTML select tag. It is displayed as text entry between the opening and closing HTML option tag. If `value` is not set, `text` also represents the internal value within the HTML `select` tag. Important: The text and value parameters have to derive from the same schema. The `select` tag itself can be embedded in another schema.
value	false	specifies an X-Query expression for the field that is the internal value in the HTML select tag. This field is transformed into the value attribute of the HTML option tag.
distinct	false	if required, the distinct (unique) values are added to the selection box; duplicates are segregated. The field addressed by the X-Query expression within the text parameter represents the unique field.

Explanation

Fills an HTML select element with data from a query result. Can be used in query and modify pages to fill a value range with the results of a query. If the HTML select tag already contains an option, the new entries from a query result are appended.

You can use select tags within queries. Thus, the parameter name is passed to the HTML select tag using the corresponding query expression according to query definition (see the user documentation section Defining and Processing Queries).

You can omit the name parameter if you proceed a simple input action (without query).

Nesting select tags within edit tags is also possible.

Example <select> Definition


<bdm:select module="bdProp"
    text="/Property/@Category" distinct="true">
      <select name="query(/Property/@Category)">
              <option value=" ">All</option>
      </select>

</bdm:select>

This example gets the query result, builds up a list of values and deletes redundant results using the distinct parameter.

The mapping between the text and value query results is done documentwise via the document ID.

graphics/mapping.png

The following graphic is based on the Property tutorial as introduced in the user documentation. It shows a use case for searching properties that are previously saved as favourite PropCustomer schema instances:

graphics/select.png

Limitations

If the parameters text and value are set, only fitting key-value pairs are displayed. That means if no value for the appropriate text ist found, the text will not be displayed.

Note:
For further information, please refer to the Simple Sample within Tamino X-Application.

				Copyright © 2002 Software AG
				All rights reserved