In the context of a form tag, represents a drop-down list or listbox. This tag should contain one or more option tags since the content of each option tag defines the options that display in the drop-down list. The drop-down options are only visible when the form is in edit mode (the form's editmode attribute must equal "edit"). If the form is in display mode, only the currently selected option tag displays. However, if you supply a value in the size HTML attribute, which indicates that the select tag should display as a listbox, the resulting <select> field displays all the options, but specifies the readonly HTML attribute, which prohibits the user from changing the option selected in the drop-down list.

Contexts

Valid in:

form

option

<domino:select
name="control name"
itemname="item name"
format="display format of options"
defaultformula="item default value derived from a formula"
defaultvalue="item default value derived from a simple value" multivalue="true|false"
mvdisplayseparator="blank|comma|colon|semicolon"
mveditseparator="blank|comma|colon|semicolon"
datatype=""
locale="<languageCode>_<countryCode>"
timezone="time zone"
debug="true|false"
onfailure="inline|exception"
time="true|false"
The standard HTML tag attributes listed below>

datatype

Specifies the type of item being added to a new document as well as the automatic validation being performed on the server. Must be one of the following:

Value	Description:
text	Does not validate or convert the value entered.
number	Validates or converts the value entered to a number.
date	Validates or converts the value entered to a date.
datetime	Validates or converts the value entered to a datetime field with the format: 10/02/99 10:10 PM.
readers	Does not validate or convert the value entered. Treats the item as a readers field.
authors	Does not validate or convert the value entered. Treats the item as an authors field.
names	Does not validate or convert the value entered. Treats the item as a names field.
richtext	Does not validate or convert the value entered.

Default is text. The tag tries to save the data as the data type specified but can be overridden by the document. Optional.

Enables you to supply the default value of the item using a Notes formula. If you supply a schema attribute for the form tag that contains this tag, the default value of the item in the referenced form takes precedence over the value derived using this formula. Optional.

Default value for the item specified as a simple value. The string you supply is converted based on the datatype, locale, mveditseparator, and multivalue attribute values you supply. Supply default date values in ISO format, because the browser client's locale can change. If you supply a schema attribute for the form tag that contains this tag, the default value of the item in the referenced form takes precedence over the value specified in this attribute. Optional.

Format to use to display the value of the selected option, as specified by the keywords supplied. See Formatting JSP content for a list of available formatting keywords. Optional.

Name of the item in the document. Supply a value for this attribute if the control name needs to be different from the item name due to invalid characters in the item name, for example. By default, this value defaults to the value in the name attribute. Optional.

Locale to use to convert the numbers and dates that display. If specified, overrides the locale that the browser specifies in the AcceptLang string. Use the following syntax: "<languageCode>_<countryCode>". See Locale codes for more details. By default, uses the first locale specified in the AcceptLang string for the browser. Optional.

Boolean value. If true, the field supports multiple values. Setting this to true forces the generation of a "multiple" HTML attribute in the resulting HTML <select> tag. Each option having a value that is equal to the multiple value in the item is selected by default. Optional.

Indicates what character to use to separate multiple values when displaying a multiple value field in either read or edit mode. Must be one of the following: blank, comma, semicolon. Default is semicolon. Optional.

Indicates what character to use to separate multiple values in a multi-value field during data entry. Must be one or more of the following: blank, comma, semicolon. To specify multiple separators, separate each with a comma. Default is comma, semicolon. If the value specified in the mvdisplayseparator attribute is not specified here as well, it is automatically added. Optional.

Name of the control on the Web page. By default, this is also the name of the item in the document. Required.

Time zone to use to display the date. If you do not specify a value, defaults to the time zone of the server (not the browser). Optional.

HTML Attributes

Domino supports the following HTML tag attributes. See the Common HTML tag attributes section for their definitions.

accesskey

align

disabled

multiple

size

tabindex

The Domtags tag library

Glossary