OBJECT:
Option
new
Option([text[, value[, defaultSelected[, selected]]]])
An Option object is created for every option in a selection
list, and is put in the options property of the Select
object. It can be created in one of two ways: you can either use the
HTML <OPTION> tag, or use the Option constructor. Using
HTML you could create a 'Dachshund' option for a selection list of dog
breeds as follows:
Code:
<option> Dachshund
You could also create the same option using the Option constructor
and assigning it to an index of the options property of the relevent
Select object:
Code:
document.myForm.dogBreed[4] = new Option("Dachshund")
After creating an Option object in this way you must refresh
the document by using history.go(0) at the end of the code. Using
the Option constructor, you can optionally specify a value to
be returned to the server when an option is selected and the form submitted
(in this case "dachs"):
Code:
new Option("Dachshund", "dachs")
It is also possible to specify whether the option is initially selected,
and whether it is currently selected using the values true and
false. Expanding on the previous example, the following code
specifies that the Dachshund option should not initially be selected,
but that it should be currently selected:
Code:
new Option("Dachshund", "dachs", false, true)
PROPERTIES
defaultSelected Property
This property, by default tainted, is a Boolean value which initially
reflects whether an option was declared with the HTML SELECTED attribute,
reading true if it was and false if not
Syntax: object.defaultSelected
selected Property
This property, which is tainted by default, is a Boolean value reflecting
whether a particular option is selected, returning true if it
is and false if not. The selected property can be set
at any time, immediately updating the display of the Select object.
Syntax: object.selected
text Property
This property, by default tainted, reflects the text value following
any particular HTML OPTION tag for a Select object. It can be
reset at any time, immediately updating the display of the selection.
Syntax: object.text
value Property
This property, tainted by default, is a string value that is returned
to the server when an option is selected and the form submitted. It
reflects the VALUE attribute in the HTML. If there is no VALUE attribute,
then the value property is an empty string.
Syntax: object.value
METHODS
The Select object inherits the watch
and unwatch methods from the
Object object.
Copyright 2000 by Infinite Software
Solutions, Inc.
Trademark Information