 | JavaScript | |||
|---|---|---|---|---|
| Prev | Home | Up | Next |
| Availability: |
| |||||||
| Inherits from: | Element object object | |||||||
| JavaScript syntax: | IE | mySelect = myDocument.all.anElementID | ||||||
| IE | mySelect = myDocument.all.anElementID.elements[anIndex] | |||||||
| IE | mySelect = myDocument.all.tags("SELECT")[anIndex] | |||||||
| IE | mySelect = myDocument.all[aName] | |||||||
| - | mySelect = myDocument.getElementById(anElementID) | |||||||
| - | mySelect = myDocument.getElementsByName(aName)[anIndex] | |||||||
| - | mySelect = myDocument.getElementsByTagName("SELECT")[anIndex] | |||||||
| - | mySelect = myForm.aSelectName | |||||||
| - | mySelect = myForm.elements[anIndex] | |||||||
| - | mySelect = myForm[anIndex] | |||||||
| HTML syntax: | <SELECT> ... </SELECT> | |||||||
| Argument list: | anIndex | A valid reference to an item in the collection | ||||||
| aName | The name attribute of an element | |||||||
| anElementID | The ID attribute of an element | |||||||
| aFormIndex | A reference to a particular form in the forms collection | |||||||
| Object properties: | accessKey, dataFld, dataSrc, form, length, multiple, selectedIndex, size, tabIndex, type, value | |||||||
| Object methods: | add(), remove(), tags() | |||||||
| Event handlers: | onAfterUpdate, onBeforeUpdate, onBlur, onChange, onDragStart, onFilterChange, onFocus, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp, onResize, onRowEnter, onRowExit, onSelectStart | |||||||
| Collections: | options[] | |||||||
Many properties, methods and event handlers are inherited from the Input object class. Refer to topics grouped with the "Input" prefix for details of common functionality across all sub-classes of the Input object super-class.
Unusually, there actually is a Select object class where most other kinds of input are instances of an Input object.
Event handling support via properties containing function objects was added to Select popup objects at version 1.1 of JavaScript.
Unlike MSIE, the Netscape Navigator implementation of this object type does not support the click() method.
The MSIE instance of this object is actually a SELECT object and not a Select object. This is another example of class naming differences between browsers that may cause problems later.
Note that this FormElement object type does not have a value property. You may need to make allowances for that in generic form object handlers. Its value is reflected by the option item that is currently selected. This FormElement object is not a sub-class of the Input object as many other FormElements are.
<HTML>
<HEAD>
</HEAD>
<BODY>
<DIV ID="RESULT">???</DIV>
<FORM>
<HR>
<SELECT ID="IN1">
<OPTION VALUE="0">Sunday
<OPTION VALUE="1">Monday
<OPTION VALUE="2">Tuesday
<OPTION VALUE="3">Wednesday
<OPTION VALUE="4">Thursday
<OPTION VALUE="5">Friday
<OPTION VALUE="6">Saturday
</SELECT>
<INPUT TYPE="button" VALUE="CLICK ME" onClick="clickMe()">
</FORM>
<SCRIPT>
//MSIE Only
function clickMe()
{
selectedValue = document.all.IN1.value;
document.all.RESULT.innerText = selectedValue;
}
</SCRIPT>
</BODY>
</HTML>| Property | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| accessKey | 1.0  | 1.0 | 2.0 | 3.02 | 3.0 |  | | 1 | | |  |
| dataFld | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| dataSrc | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| form | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| length | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | ReadOnly. |
| multiple | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| selectedIndex | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | - |
| size | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| tabIndex | 1.0 | 1.0 | 2.0 | 3.02 | 3.0 | | | 1 | | | |
| type | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | 1 | | | ReadOnly. |
| value | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| Method | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| add() | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| remove() | 1.5 | 3.0 | 6.0 | 4.0 | | | | 1 | | | - |
| tags() | | 3.0 | | 4.0 | | | | | | | - |
| Event name | JavaScript | JScript | N | IE | Opera | NES | ECMA | DOM | CSS | HTML | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|
| onAfterUpdate | | 3.0 | | 4.0 | | | | | | | - |
| onBeforeUpdate | | 3.0 | | 4.0 | | | | | | | - |
| onBlur | 1.1 | 3.0 | 3.0 | 4.0 | 3.0 | | | | | | |
| onChange | 1.0 | 3.0 | 2.0 | 4.0 | 3.0 | | | | | | - |
| onDragStart | | 3.0 | | 4.0 | | | | | | | - |
| onFilterChange | | 3.0 | | 4.0 | | | | | | | - |
| onFocus | 1.0 | 3.0 | 2.0 | 4.0 | 3.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 | |
| onResize | 1.2 | 3.0 | 4.0 | 4.0 | | | | | | | |
| onRowEnter | | 3.0 | | 4.0 | | | | | | | - |
| onRowExit | | 3.0 | | 4.0 | | | | | | | - |
| onSelectStart | | 3.0 | | 4.0 | | | | | | | - |
| Prev | Home | Next |
| Security policy | Up | Select.add() |
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. | ||