INPUT

<INPUT
ACCESSKEY=key
CLASS=classname
DISABLED
ID=value
MAXLENGTH=n
READONLY
STYLE=css1-properties
TYPE=BUTTON | CHECKBOX | FILE | HIDDEN | IMAGE | PASSWORD | RADIO | RESET | SUBMIT | TEXT
VALUE=value
VOICEFILE=url
GRAMMAR=url | strings
LANGUAGE=JAVASCRIPT | JSCRIPT | VBSCRIPT | VBS
event = script
>

Specifies a form input control.

Attributes

ACCESSKEY= key

Specifies the key attached to the menu item. If the ACCESSKEY attribute is not defined or the ACCESSKEY defined cannot be associated with the menu item, the WTE automatically assigns an ACCESSKEY attribute. For more information, see Assigning Dual Tone Multi-Frequency Digits to Menu Items.

CLASS= classname

Specifies the class of the element being defined. This is used to associate a subclassed style sheet with the element.

DISABLED

Used to disable an element. Does not affect whether the element breaks or begins a menu.

ID= value

An SGML ID used as the target for hypertext links or for naming particular elements in associated style sheets. Valid ID values must begin with a letter. The underscore ("_") can be used in the ID name. The ID should be unique throughout the document. If more than one object with the same ID exists in a document, a collection of those named items is created that can be referenced only by ordinal position.

MAXLENGTH= n

Indicates the maximum number of characters that can be entered into a text control. This attribute applies to INPUT elements that have the TYPE=text or TYPE=password attribute.

READONLY

Causes the element's contents to be read-only. Affects the control in the same way as disable does. This attribute applies to INPUT elements that have the TYPE=text or TYPE=password attribute.

STYLE= css1-properties

Specifies an inline style sheet for the element.

TYPE=[button | checkbox | file | hidden | image | password | radio | reset | submit | text

Specifies the type of intrinsic control. The default is text.

Type	Description
button	Inside a form, it is rendered as a form button. Otherwise rendered as a stand-alone button.
Checkbox	Used for Boolean menus. Rendered as a menu with two available through the SelectCheckBoxKey and ClearCheckBoxKey properties.
File	Breaks any menu, like a disabled control.
Hidden	This element is ignored .
image	Rendered as a form button.
Password	The same as the TEXT input type.
Radio	Rendered as a menu, with all radio elements with the same name and scope (inside or outside a FORM). Radio elements are rendered as menu items in the order they appear in the page, regardless of the first radio element actually found. Disabled radio elements are not rendered. Radio elements belonging to the current element group are not rendered again while the WTE is in their scope. That is, radio elements outside a form are not rendered again while in the same page, and radio elements inside a form are not rendered again unless the form is exited and re-entered, or the reset button is pressed. Outside a form, radio buttons are rendered whenever the Internet Explorer Reload or Refresh methods are invoked. Inside a form, re-rendering takes place just as it does during normal navigation, and is determined by the site whose URL is shown in the Internet Explorer Address list.
Reset	Rendered as a form button. If it is clicked when the cursor is inside a form, radio menus inside this form are re-rendered again whenever the WTE meets a radio element with a name that has already been rendered. Using OnReset = "return false;" to cancel the default behavior has no effect on the WTE.
Submit	Rendered as a form button.
Text	Used for a single-line text-entry field. All DTMF until the termination string or MAXLENGTH digits are entered as its value.

VALUE= value

Used as the text attached to form buttons in TTS rendering mode.

VOICEFILE= url

Specifies the voice file attached with this element.

GRAMMAR= url | strings

If the value of the TYPE attribute is text, the GRAMMAR attribute specifies the grammar (.cfg) file, in SAPI format, that provides a hint to the engine about what the caller is expected to say. The grammar file replaces the default grammar file that the SR engine uses in dictation. The default grammar file does not provide any hint to the engine. Use the format "url(filename.cfg)" to specify the .cfg file. Note that the WTE requires a grammar file to be in Unicode format. For the complete syntax of .cfg files, see the SAPI 4.0a documentation.

If the value of the TYPE attribute is not text, the GRAMMAR attribute specifies a set of alternative words or phrases for the menu item. The caller can select the menu item by speaking any word or phrase in the set. This attribute is ignored if SR is not enabled.

LANGUAGE= JAVASCRIPT | JSCRIPT | VBS | VBSCRIPT

Specifies the language in which the current script is written and invokes the proper scripting engine. The default value is JAVASCRIPT.

Language	Description
JAVASCRIPT, JSCRIPT	The scripting language is written in JScript.
VBS, VBSCRIPT	The scripting language is written in VBScript.

event

Can be one or more of these events:

onclick

onselectiontimeout

onselectionerror

onchange

Remarks

All form buttons (BUTTON, SUBMIT, RESET and IMAGE) are rendered alike—as menu items inside a form and as stand-alone buttons outside a form. Their impact on the document is not changed. A form button always breaks a non-form button menu, and no other menu items can join a form-button menu. If a form-button menu contains only a single item, the WTE will select it without offering it to the caller.

Any control that is not a form button will break any menu, even if it is disabled or read-only.

See Also

FORM