User input elements

input select option optgroup fieldset

input
The input element specifies a text entry object. The user input is constrained by the optional format attribute.
attributes


name
Specifies the name of the variable to set with the result of the user's text input. The name variable's value is used to pre-load the text entry object. If this value does not conform to the input mask, the browser will unset the variable and attempt to initialize the variable with the value attribute.
type
Specifies the type of text-input area. The following values are allowed: text (text entry control) or password (a text entry control where each character is displayed in an illegible form, such as with asterisks). Default is text.
value
The value attribute indicates the default value of the variable named in the name attribute. When the element is displayed and the variable named in the name attribute is not set, the name variable is assigned the value specified in the value attribute. If the name variable already contains a value, the value attribute is ignored. If the value attribute specifies a value that does not conform to the input mask specified by the format attribute, the browser must ignore the value attribute. In the case where no valid value can be established, the name variable is left unset.
format
Specifies an input mask for user input entries. The string consists of mask control characters and static text that is displayed in the input area. The format control characters specify the data format expected to be entered by the user. The format codes are:
'A' (entry of any upper-case, non-numeric character);
'a' (entry of any lower-case, non-numeric character);
'N' (entry of any numeric character);
'X' (entry of any upper-case character);
'x' (entry of any lower-case character);
'M' or 'm' (entry of any character);
'*f' (entry of any number of characters where f is one of the above format codes);
'nf' (entry of n characters where n is from 1 to 9 and f is one of the above format codes);
'\c' (display the character, c, in the entry field: these characters are considered part of the input's value).
emptyok
Indicates that this input element accepts empty input although a non-empty format string has been specified. Default is false.
size
Specifies the width, in characters, of the text-input area.
maxlength
Specifies the maximum number of characters that can be entered by the user in the text-entry area.
tabindex
Specifies the tabbing position of the current element. The tabbing position indicates the relative order in which elements are traversed when tabbing within a single WML card.
title
Specifies a title for this element, which may be used in the presentation of this object.
accesskey
Assigns an access key (a single character from the document character set) to an element to allow the user to activate a particular element by using a single key. The phones usually have "0"-"9", "*" and "#" keys. Activating an access key assigned to an element gives focus to the element. When the user activates a input, it allows input. The access key may be recognized directly, or it may be necessary to press it in conjunction with a "command" key.
id
Provides an element with a unique name within a single deck.
class
Affiliates an element with one or more classes.
xml:lang
Specifies the natural or formal language in which the document is written.

select
The select element lets users pick from a list of options. Each option is specified by an option element. Each option element may have one line of formatted text. Option elements may be organised into hierarchical groups using the optgroup element.
attributes


name
Specifies the name of the variable to set with the result of the selection. The name variable's value is used to pre-load the text entry object.
value
Indicates the default value of the variable named in the name attribute. When the element is displayed, and the variable named in the name attribute is not set, the name variable may be assigned the value specified in the value attribute, depending on the values defined in iname and ivalue. If the name variable already contains a value, the value attribute is ignored. Any application of the default value is done before the list is pre-selected with the value of the name variable. If this element allows the selection of multiple options, the result of the user's choice is a list of all selected values, separated by the semicolon character. The name variable is set with this result. Similarly, the value attribute is interpreted as a semicolon-separated list of pre-selected options.
iname
Indicates the name of the variable to be set with the index result of the selection. The index result is the position of the currently selected option in the select list. An index of zero indicates that no option is selected. Index numbering begins at one and increases monotonically.
ivalue
Indicates the default-selected option element. When the element is displayed, if the variable named in the iname attribute is not set, it is assigned the default-selected entry. If the variable already contains a value, the ivalue attribute is ignored. If the iname attribute is not specified, the ivalue value is applied every time the element is displayed. If this element allows the selection of multiple options, the index result of the user's choice is a list of the indices of all the selected options, separated by the semicolon character. The iname variable is set with this result. Similarly, the ivalue attribute is interpreted as a semicolon-separated list of pre-selected options.
multiple
Indicates that the select list should accept multiple selections. When not set, the select list should only accept a single selected option. Default is false.
tabindex
Specifies the tabbing position of the current element. The tabbing position indicates the relative order in which elements are traversed when tabbing within a single WML card.
title
Specifies a title for this element, which may be used in the presentation of this object.
id
Provides an element with a unique name within a single deck.
class
Affiliates an element with one or more classes.
xml:lang
Specifies the natural or formal language in which the document is written.

option
This element specifies a single choice option in a select element.
attributes


value
Specifies the value to be used when setting the name variable. When the user selects this option, the resulting value specified in the value attribute is used to set the select element's name variable. The value attribute may contain variable references, which are evaluated before the name variable is set.
onpick
The URI that is loaded when the user selects or deselects this option.
title
Specifies a title for this element, which may be used in the presentation of this object.
id
Provides an element with a unique name within a single deck.
class
Affiliates an element with one or more classes.
xml:lang
Specifies the natural or formal language in which the document is written.

optgroup
The optgroup element allows the author to group related option elements into a hierarchy. The browser may use this hierarchy to facilitate layout and presentation on a wide variety of devices.
attributes


title
Specifies a title for this element, which may be used in the presentation of this object.
id
Provides an element with a unique name within a single deck.
class
Affiliates an element with one or more classes.
xml:lang
Specifies the natural or formal language in which the document is written.

fieldset
Allows the grouping of related fields and text. This grouping allows the optimizing of layout and navigation. Fieldset elements may nest, providing the author with a means of specifying behavior across a wide variety of devices.
attributes


title
Specifies a title for this element, which may be used in the presentation of this object.
id
Provides an element with a unique name within a single deck.
class
Affiliates an element with one or more classes.
xml:lang
Specifies the natural or formal language in which the document is written.