Input object (Object/DOM)

Another name for a FormElement object.

Availability:

DOM level - 1
JavaScript - 1.0
JScript - 1.0
Internet Explorer - 3.02
Netscape - 2.0
Inherits from:Element object
JavaScript syntax:-myInput = myDocument.aFormName.anElementName
-myInput = myDocument.aFormName.elements[anItemIndex]
IEmyInput = myDocument.all.anElementID
IEmyInput = myDocument.all.tags("INPUT")[anIndex]
IEmyInput = myDocument.all[aName]
-myInput = myDocument.forms[aFormIndex].anElementName
-myInput = myDocument.forms[aFormIndex].elements[anItemIndex]
-myInput = myDocument.getElementById(anElementID)
-myInput = myDocument.getElementsByName(aName)[anIndex]
-myInput = myInputArray[aName]
-myInput = myInputArray[anIndex]
-myInput = myDocument.getElementsByTagName("INPUT")[anIndex]
HTML syntax:<INPUT TYPE="aType">
Argument list:anIndexA valid reference to an item in the collection
aNameThe name attribute of an element
anElementIDThe ID attribute of an element
anItemIndexA valid reference to an item in the collection
aFormIndexA reference to a particular form in the forms collection
Object properties:accept, accessKey, align, alt, checked, dataFld, dataFormatAs, dataSrc, defaultChecked, defaultSelected, defaultValue, disabled, form, length, maxLength, name, readOnly, recordNumber, selected, selectedIndex, size, src, status, tabIndex, type, value
Object methods:blur(), click(), createTextRange(), focus(), handleEvent(), select()
Event handlers:onAfterUpdate, onBeforeUpdate, onBlur, onChange, onClick, onDblClick, onFocus, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp, onRowEnter, onRowExit, onSelect

This is a generic description of a form element object. The object will really be a concrete manifestation of a particular class, but is available generally as an item in the elements array that belongs to the form.

We have tried to conceive a general model of the object relationships in a browser, a difficult task - we document a general purpose class referred to as an Element object. Most displayable items in a document that are instantiated by an HTML tag can be considered to be sub-classes of the Element object.

Input objects, collectively, are a sub-class of the Element object class so to avoid over-duplicating the same coverage, properties, methods, events and collections that are specific to Input objects are discussed here and are omitted from the discussion topics relating to the Element object. They are listed in the property, method, collection and event summary for the Element object.

Likewise, under the Input object, those properties, method, collections and events that apply generally to all kinds of Input objects are documented here, but those that are specific to only a particular kind of Input object sub-class are covered under specific topics relating to that class.

Some properties and methods of the Input objects and its specific sub-classes are platform specific. The dataFld, dataSrc and dataFormatAs properties are only available in MSIE. Assigning event handlers to onevent properties may also support different event sets in each browser platform.

MSIE supports an INPUT object class rather than an Input object class.

Warnings:

See also:FIELDSET object, ISINDEX object, Label object, Legend object

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
accept1.5 1.55.0 5.06.0 6.05.0 5.0 n/a n/a n/a1 1 n/a n/a-
accessKey1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
align1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
alt1.5 1.53.0 3.06.0 6.03.02 3.02 n/a n/a n/a1 1 n/a n/a-
checked1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/a-
dataFld n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
dataFormatAs n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
dataSrc n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
defaultChecked1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/a-
defaultSelected1.0 1.01.0 1.02.0 2.03.02 3.02 n/a n/a n/a1 1 n/a n/aWarning
defaultValue1.0 1.01.0 1.02.0 2.03.02 3.02 n/a n/a n/a1 1 n/a n/aReadOnly.
disabled1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
form1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/aReadOnly.
length1.0 1.01.0 1.02.0 2.03.02 3.02 n/a n/a n/a1 1 n/a n/aWarning
maxLength1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
name1.5 1.55.5 5.56.0 6.05.5 5.53.0 3.0 n/a n/a1 1 n/a n/a-
readOnly1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
recordNumber n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aReadOnly.
selected1.0 1.01.0 1.02.0 2.03.02 3.02 n/a n/a n/a1 1 n/a n/aWarning
selectedIndex1.0 1.01.0 1.02.0 2.03.02 3.02 n/a n/a n/a1 1 n/a n/aWarning
size1.0 1.01.0 1.02.0 2.03.02 3.02 n/a n/a n/a1 1 n/a n/a-
src1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
status1.0 1.01.0 1.02.0 2.03.02 3.02 n/a n/a n/a1 1 n/a n/aWarning
tabIndex1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
type1.1 1.11.0 1.03.0 3.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/aReadOnly.
value1.5 1.51.0 1.06.0 6.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/a-

MethodJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
blur()1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/a-
click()1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a1 1 n/a n/a-
createTextRange() n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
focus()1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a1 1 n/a n/a-
handleEvent()1.2 1.2 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a n/a-
select()1.1 1.13.0 3.03.0 3.04.0 4.0 n/a n/a n/a1 1 n/a n/a-

Event nameJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
onAfterUpdate n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onBeforeUpdate n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onBlur1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onChange1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/a-
onClick1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onDblClick1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onFocus1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onHelp n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onKeyDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyPress1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseMove1.2 1.23.0 3.04.0 4.04.0 4.0 n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOut1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseOver1.0 1.01.0 1.02.0 2.03.02 3.023.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onRowEnter n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onRowExit n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onSelect1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/a-

Inheritance chain:

Element object, Node object

insert figure 0080