 | JavaScript | |||
|---|---|---|---|---|
| Prev | Home | Up | Next |
| Availability: |
| |||||||
| Inherits from: | Element object | |||||||
| JavaScript syntax: | - | myForm = myDocument.aFormName | ||||||
| IE | myForm = myDocument.all.anElementID | |||||||
| IE | myForm = myDocument.all.tags("FORM")[anIndex] | |||||||
| IE | myForm = myDocument.all[aName] | |||||||
| - | myForm = myDocument.forms.aFormName | |||||||
| - | myForm = myDocument.forms[aFormName] | |||||||
| - | myForm = myDocument.forms[anIndex] | |||||||
| - | myForm = myDocument.getElementById(anElementID) | |||||||
| - | myForm = myDocument.getElementsByName(aName)[anIndex] | |||||||
| - | myForm = myDocument.getElementsByTagName("FORM")[anIndex] | |||||||
| - | myForm = myFormArray[aFormName] | |||||||
| - | myForm = myFormArray[anIndex] | |||||||
| - | myForm = myInputObject.form | |||||||
| HTML syntax: | <FORM> ... </FORM> | |||||||
| Argument list: | aFormName | The name of a form in the document | ||||||
| anIndex | A reference to an element in a collection | |||||||
| aName | An associative array reference | |||||||
| anElementID | The ID value of an Element object | |||||||
| Object properties: | acceptCharset, accessKey, action, elements, encoding, enctype, length, method, name, tabIndex, target | |||||||
| Object methods: | handleEvent(), reset(), submit() | |||||||
| Event handlers: | onClick, onDblClick, onDragStart, onFilterChange, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp, onReset, onSelectStart, onSubmit | |||||||
| Collections: | elements[] | |||||||
Each <FORM> tag creates an object in the document.forms[] array. However even if the forms are given names, those names become properties within the document object and are not assigned as element names in the forms[] array, because the associative naming is lacking. Access to form objects at level 0 of the DOM may need some attention when the DOM becomes level 1.
In MSIE, the form details are collected in a FORM object rather than a Form object. It is these object naming differences that can cause some problems with scripts, and it is possible that some implementations will actually make object class references case insensitive to avoid this problem.
You can normally enumerate the properties in a Form object to access the Form input elements. However, if you place a <TEXTAREA> into a <FORM> then Netscape 4.7 on Macintosh will not enumerate the Form properties. The script halts but no error message is generated. MSIE has no problem enumerating a <FORM> containing a <TEXTAREA> tag.
| Property | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| acceptCharset | 1.5  | 5.0 | 6.0 | 5.0 |  | | | 1 | | | - |
| accessKey | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | |  |
| action | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| elements | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| encoding | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | | | | |
| enctype | 1.5 | 5.0 | 6.0 | 5.0 | | | | 1 | | | - |
| length | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | readonly |
| method | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| name | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| tabIndex | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| target | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| Method | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| handleEvent() | 1.2 | | 4.0 | | | | | | | | - |
| reset() | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | 1 | | | - |
| submit() | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| Event name | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| onClick | 1.0 | 1.0 | 2.0 | 3.0 | 3.0 | | | | | 4.0 | |
| onDblClick | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onDragStart | | 3.0 | | 4.0 | | | | | | | - |
| onFilterChange | | 3.0 | | 4.0 | | | | | | | - |
| onHelp | | 3.0 | | 4.0 | | | | | | | |
| onKeyDown | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onKeyPress | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onKeyUp | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onMouseDown | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onMouseMove | 1.2 | 3.0 | 4.0 | 4.0 | | | | | | 4.0 | |
| onMouseOut | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onMouseOver | 1.0 | 1.0 | 2.0 | 3.0 | 3.0 | | | | | 4.0 | |
| onMouseUp | 1.2 | 3.0 | 4.0 | 4.0 | 3.0 | | | | | 4.0 | |
| onReset | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | | | | - |
| onSelectStart | | 3.0 | | 4.0 | | | | | | | - |
| onSubmit | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | | | | - |
| Prev | Home | Next |
| Form element | Up | Form.acceptCharset |
JavaScript Programmer's Reference, Cliff Wootton Wrox Press (www.wrox.com) Join the Wrox JavaScript forum at p2p.wrox.com Please report problems to support@wrox.com © 2001 Wrox Press. All Rights Reserved. Terms and conditions. | ||