<input> tag

<input> element

The <input> element lets the user enter text which the device assigns to a specified variable.

Syntax

text

<input name="variable" title="label" type="type"

value="value" format="specifier"

emptyok="boolean" size="n" maxlength="n" tabindex="n"/>

where text represents the text and/or image the device will display to prompt the user for entry.

Attributes

name	The name of the variable in which the device stores the text entered by the user. If the variable has no value, the device sets it to the value specified for the `default` attribute. If you do not specify a `default` value, the device initializes the variable to an empty string (`""`). When the device displays the `<input>` element, the value in the specified variable appears in the entry field.
`title`	Specifies a brief label for the input item. Some devices use the label as a tooltip when displaying the input field. Others might use it as a label for a user interface mechanism that lets the user navigate to the item. For example, if a device cannot display all card content on one screen and `ordered="true"`, the UP.Browser uses the `title` to identify this input item on a summary-level menu.
`type`	`text` \| `password` Specifies how the device should display text the user enters. Specifying `type="text"` causes the text to be visible. Specifying `type="password"` causes the text to be masked (for example, replaced by "``" characters). Note that the `password` mode is not encrypted* so you should not rely on it for securing critical data.
`value`	This attribute is identical in syntax and behavior to the `default`* attribute (see below)*.
`accesskey`	A number (0-9) that appears on the left side of the screen next to the link. If the user presses the corresponding key on the phone keypad, the phone executes the task defined by the link. We recommend that you number the links in the order in which they appear.
`format`	Specifies a data format that the user entry must match (see Specifying a format mask below). If you omit this attribute, the device assumes `*M` (default uppercase first character followed by up to `maxlength` number of mixed case alphabetic and numeric characters).
`emptyok`	`true` \| `false` Specifies whether the user can leave the field blank. Specifying `emptyok="true"` indicates that the field is optional--if the user enters a value, however, the device applies any entry requirements you specify for the `format` attribute (see above).
`size`	The UP.Browser software does not currently support this attribute.
`maxlength`	Specifies the maximum number of characters the user can enter. If you do not specify the `maxlength` attribute, the UP.Browser imposes a limit of 256 characters.
`tabindex`	The UP.Browser software does not currently support this attribute.

Specifying a format mask

You can specify the following values for the format attribute:

Tag	Description
`A`	Any symbolic or uppercase alphabetic character (no numbers)
`a`	Any symbolic or lowercase alphabetic character (no numbers)
`N`	Any numeric character (no symbols or alphabetic characters)
`X`	Any symbolic, numeric, or uppercase alphabetic character (not changeable to lowercase)
`x`	Any symbolic, numeric, or lowercase alphabetic character (not changeable to uppercase)
`M`	Any symbolic, numeric, or uppercase alphabetic character (changeable to lowercase)--for multiple character input, defaults to uppercase first character
`m`	Any symbolic, numeric, or lowercase alphabetic character (changeable to uppercase)--for multiple character input, defaults to lowercase first character

To limit the number of characters users can enter, you can specify a single digit number before the character tag--for example, format="3X" lets the user enter a maximum of three symbolic, numeric, or uppercase alphabetic characters.
To let users enter an unlimited number of characters, specify an asterisk (*) before the character tag--for example, format="*a" lets the user enter any number of symbolic or lowercase alphabetic characters.

Example

<wml>

<card>

<p>

First Name:

<input name="fname" maxlength="15" /> <br/>

Last Name:

<input name="lname" maxlength="15" /> <br/>

State:

<input name="state" maxlength="2" emptyok="true" value="CA" /> <br/>

Zipcode:

<input name="zipcode" maxlength="9" /> <br/>

Password:

<input name="password" maxlength="8" type="password" />

</p>

</card>

</wml>