dom.html.HTMLSelectElement

Public Properties

	Property		Defined By
		DOM 1 Core attributes : NamedNodeMap [read-only] Returns an unordered collection of Attr nodes.	Node
		Non-Standard baseName : DOMString [read-only] Returns the base name for the name qualified with the namespace.	Node
		DOM 3 Core baseURI : DOMString [read-only] The absolute base URI of this node or null if the implementation wasn't able to obtain an absolute URI.	Node
		baseURIObject : nsIURI [read-only] Non-Standard \| FireFox 3+ Returns the nsIURI object representing the element's URI.	Element
		Element Traversal childElementCount : Number [read-only] Returns the current number of element nodes that are children of this element.	Element
		DOM 1 Core childNodes : NodeList [read-only] Returns an ordered collection of node objects that are children of the current element.	Node
		children : NodeList [read-only] ? \| FireFox 3.5+ Returns a collection of child elements of the given element.	Element
		className : DOMString The class attribute of the element.	HTMLElement
		DOM 3 Core clientHeight : Number [read-only] Returns the inner height of an element in pixels, including padding but not the horizontal scrollbar height, border, or margin.	Element
		DOM 3 Core clientLeft : Number [read-only] The width of the left border of an element in pixels.	Element
		DOM 3 Core clientTop : Number [read-only] The width of the top border of an element in pixels.	Element
		DOM 3 Core clientWidth : Number [read-only] Returns the inner width of an element in pixels.	Element
		Non-Standard dataType : * Specifies the data type for this node.	Node
		Non-Standard definition : Node [read-only] Returns the definition of the node in the document type definition (DTD) or schema.	Node
		dir : DOMString The dir attribute gets or sets the text writing directionality of the content of the current element.	HTMLElement
		disabled : Boolean The control is unavailable in this context.	HTMLSelectElement
		DOM 1 Core firstChild : Node [read-only] Returns the node's first child in the tree, or null if the node is childless.	Node
		Element Traversal firstElementChild : Element [read-only] Returns the first child element node of this element.	Element
		form : HTMLFormElement [read-only] Returns the FORM element containing this control.	HTMLSelectElement
		id : DOMString Gets or sets the element's identifier.	HTMLElement
		innerHTML : DOMString DOM Level 0 \| NS\FireFox\IE4+ Sets or gets all of the markup and content within a given element.	Element
		lang : DOMString This property gets or sets the base language of an element's attribute values and text content.	HTMLElement
		DOM 1 Core lastChild : Node [read-only] Returns the last child of a node.	Node
		Element Traversal lastElementChild : Element [read-only] Returns the last child element node of this element.	Element
		length : Number Modified in DOM Level 2 The number of options in this SELECT.	HTMLSelectElement
		DOM 2 Core localName : DOMString [read-only] Returns the local part of the qualified name of this node.	Node
		multiple : Boolean If true, multiple OPTION elements may be selected in this SELECT.	HTMLSelectElement
		name : DOMString Form control or object name when submitted with a form.	HTMLSelectElement
		DOM 2 Core namespaceURI : DOMString [read-only] The namespace URI of the node, or null if it is unspecified (read-only).	Node
		Element Traversal nextElementSibling : Element [read-only] Returns the next sibling element node of this element.	Element
		DOM 1 Core nextSibling : Node [read-only] Returns the node immediately following the specified one in its parent's childNodes list, or null if the specified node is the last node in that list.	Node
		DOM 1 Core nodeName : DOMString [read-only] Returns the name of the current node as a string.	Node
		Non-Standard nodePrincipal : nsIPrincipal [read-only] Returns the nsIPrincipal object representing current security context of the node.	Node
		DOM 1 Core nodeType : Number [read-only] Returns an integer code representing the type of the node.	Node
		Non-Standard nodeTypedValue : * Contains the node value expressed in its defined data type.	Node
		Non-Standard nodeTypeString : DOMString [read-only] Returns the node type in string form.	Node
		DOM 1 Core nodeValue : DOMString Returns or sets the value of the current node.	Node
		DOM 3 Core offsetHeight : Number [read-only] Height of an element relative to the element's offsetParent.	Element
		DOM 3 Core offsetLeft : Number [read-only] Returns the number of pixels that the upper left corner of the current element is offset to the left within the offsetParent node.	Element
		DOM 3 Core offsetParent : Element [read-only] The element from which all offset calculations are currently computed.	Element
		DOM 3 Core offsetTop : Number [read-only] Returns the distance of the current element relative to the top of the offsetParent node.	Element
		DOM 3 Core offsetWidth : Number [read-only] The width of an element, relative to the layout.	Element
		onblur : Function The onblur event occurs when an element loses focus either by the pointing device or by tabbing navigation.	HTMLSelectElement
		onchange : Function The onchange event occurs when a control loses the input focus and its value has been modified since gaining focus.	HTMLSelectElement
		onclick : Function a pointer button was clicked	HTMLElement
		oncopy : Function Non-Standard \| Firefox 3+ This event is sent when the user attempts to copy text.	HTMLElement
		oncut : Function Non-Standard \| Firefox 3+ This event is sent when the user attempts to cut text.	HTMLElement
		ondblclick : Function a pointer button was double clicked	HTMLElement
		onfocus : Function The onfocus event occurs when an element receives focus either by the pointing device or by tabbing navigation.	HTMLSelectElement
		onkeydown : Function a key was pressed down	HTMLElement
		onkeypress : Function a key was pressed and released	HTMLElement
		onkeyup : Function a key was released	HTMLElement
		onmousedown : Function a pointer button was pressed down	HTMLElement
		onmousemove : Function a pointer was moved within	HTMLElement
		onmouseout : Function a pointer was moved away	HTMLElement
		onmouseover : Function a pointer was moved onto	HTMLElement
		onmouseup : Function a pointer button was released	HTMLElement
		onpaste : Function Non-Standard \| Firefox 3+ This event is sent when the user attempts to paste text.	HTMLElement
		options : HTMLOptionsCollection [read-only] Modified in DOM Level 2 The collection of OPTION elements contained by this element.	HTMLSelectElement
		DOM 1 Core ownerDocument : Document [read-only] The Document object associated with this node.	Node
		DOM 1 Core parentNode : Node [read-only] Returns the parent of the specified node in the DOM tree.	Node
		Non-Standard parsed : Boolean [read-only] Indicates the parsed status of the node and child nodes.	Node
		DOM 2 Core prefix : DOMString Returns the namespace prefix of the specified node, or null if no prefix is specified.	Node
		Element Traversal previousElementSibling : Element [read-only] Returns the previous sibling element node of this element.	Element
		DOM 1 Core previousSibling : Node [read-only] Returns the node immediately preceding the specified one in its parent's childNodes list, null if the specified node is the first in that list.	Node
		schemeTypeInfo : TypeInfo [read-only] DOM Level 3 \| None The type information associated with this element.	Element
		DOM 3 Core scrollHeight : Number [read-only] Height of the scroll view of an element; it includes the element padding but not its margin.	Element
		DOM 3 Core scrollLeft : Number Gets or sets the number of pixels that an element's content is scrolled to the left.	Element
		DOM 3 Core scrollTop : Number Gets or sets the number of pixels that the content of an element is scrolled upward.	Element
		DOM 3 Core scrollWidth : Number [read-only] Returns either the width in pixels of the content of an element or the width of the element itself, whichever is greater.	Element
		selectedIndex : Number The ordinal index of the selected option, starting from 0.	HTMLSelectElement
		size : Number Number of visible rows.	HTMLSelectElement
		Non-Standard specified : Boolean [read-only] Indicates whether the node (usually an attribute) is explicitly specified or derived from a default value in the document type definition (DTD) or schema.	Node
		style : CSSStyleDeclaration [read-only] Returns an object that represents the element's style attribute.	HTMLElement
		tabIndex : Number Gets/sets the tab order of the current element.	HTMLSelectElement
		DOM 2 Core tagName : DOMString [read-only] The name of the element.	Element
		Non-Standard text : DOMString Represents the text content of the node or the concatenated text representing the node and its descendants.	Node
		DOM 3 Core textContent : DOMString Gets or sets the text content of a node and its descendants.	Node
		title : DOMString Establishes the text to be displayed in a 'tool tip' popup when the mouse is over the displayed node.	HTMLElement
		type : DOMString [read-only] The type of this form control.	HTMLSelectElement
		value : DOMString The current form control value (i.e.	HTMLSelectElement
		Non-Standard xml : DOMString [read-only] Contains the XML representation of the node and all its descendants.	Node

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		add(element:HTMLElement, before:HTMLElement):void Add a new element to the collection of OPTION elements for this SELECT.	HTMLSelectElement
		Non-Standard addBehavior(url:DOMString):Number Attaches a behavior to the element.	Element
		DOM 2 Events addEventListener(type:DOMString, listener:EventListener, useCapture:Boolean):void Associates a function with a particular event and binds the event to the current node.	Node
		DOM 3 Events addEventListenerNS(namespaceURI:DOMString, type:DOMString, listener:EventListener, useCapture:Boolean):void Registers an event listener, depending on the useCapture parameter, on the capture phase of the DOM event flow or its target and bubbling phases.	Node
		DOM 1 Core appendChild(element:Node):Node Adds a node to the end of the list of children of a specified parent node.	Node
		Non-Standard applyElement(element:Object, where:DOMString = outside):Object Makes the element either a child or parent of another element.	Element
		Non-Standard attachEvent(type:DOMString, listener:Function):Boolean Binds the specified function to an event, so that the function gets called whenever the event fires on the object.	Element
		blur():void Causes the element to lose focus and fires the onblur event.	HTMLSelectElement
		Non-Standard clearAttributes():void Removes all attributes and values from the object.	Element
		DOM 1 Core cloneNode(cloneChildren:Boolean):Node Returns a duplicate of the current node.	Node
		DOM 3 Core compareDocumentPosition(other:Node):Number Compares the position of the current node against another node in any other document.	Node
		Non-Standard componentFromPoint(x:Number, y:Number):DOMString Returns the component located at the specified coordinates via certain events.	Element
		Non-Standard contains(element:Object):Boolean Checks whether the given element is contained within the object.	Element
		Non-Standard createControlRange():NodeList Creates a controlRange collection of nontext elements.	Element
		Non-Standard detachEvent(type:DOMString, listener:Function):void Unbinds the specified function from the event, so that the function stops receiving notifications when the event fires.	Element
		DOM 2 Events dispatchEvent(evt:Event):Boolean Dispatches an event to fire on a node artificially.	Node
		Non-Standard doScroll(scrollAction:DOMString = scrollbarDown):void Simulates a click on a scroll-bar component.	Element
		Non-Standard dragDrop():Boolean Initiates a drag event.	Element
		Non-Standard fireEvent(type:DOMString, event:Object = null):Boolean Fires a specified event on the object.	Element
		focus():void Causes the element to receive the focus and executes the code specified by the onfocus event.	HTMLSelectElement
		Non-Standard getAdjacentText(where:DOMString):DOMString Returns the adjacent text string.	Element
		DOM 1 Core getAttribute(name:DOMString):Object Returns the value of the named attribute on the specified element.	Element
		DOM 2 Core getAttributeNode(name:DOMString):Attr Returns the Attr node for the attribute with the given name.	Element
		DOM 2 Core getAttributeNodeNS(nameSpace:DOMString, name:DOMString):Attr Returns the Attr node for the attribute with the given namespace and name.	Element
		DOM 2 Core getAttributeNS(nameSpace:DOMString, name:DOMString):DOMString Returns the string value of the attribute with the specified namespace and name.	Element
		DOM 3 Core getBoundingClientRect():TextRectangle Retrieves an object that specifies the bounds of a collection of TextRectangle objects.	Element
		DOM 3 Core getClientRects():TextRectangleList Retrieves a collection of rectangles that describes the layout of the contents of an object or range within the client.	Element
		HTML 5 getElementsByClassName(name:DOMString):NodeList Returns a set of elements with the given class name.	Element
		DOM 2 Core getElementsByTagName(name:DOMString):NodeList Retrieves a collection of objects based on the specified element name.	Element
		DOM 2 Core getElementsByTagNameNS(nameSpace:DOMString, localName:DOMString):NodeList Returns a list of elements with the given tag name belonging to the given namespace.	Element
		Non-Standard getExpression(propertyName:DOMString):* Retrieves the expression for the given property.	Element
		DOM 3 Core getFeature(feature:DOMString, version:DOMString):DOMObject This method returns a specialized object which implements the specialized APIs of the specified feature and version, as specified in DOM Features.	Node
		DOM 3 Core getUserData(key:DOMString):DOMUserData Retrieves the object associated to a key on a this node.	Node
		DOM 2 Core hasAttribute(name:DOMString):Boolean DOM Level 2 \| NS\FireFox Determines whether an attribute with the specified name exists.	Element
		DOM 2 Core hasAttributeNS(nameSpace:DOMString, name:DOMString):Boolean Returns a boolean value indicating whether the current element has the specified attribute.	Element
		DOM 2 Core hasAttributes():Boolean Returns a boolean value of true or false, indicating if the current element has any attributes or not.	Node
		DOM 1 Core hasChildNodes():Boolean Returns a value that indicates whether the object has children.	Node
		Non-Standard insertAdjacentElement(where:DOMString, element:Element):Element Inserts an element at the specified location.	Element
		Non-Standard insertAdjacentHTML(where:DOMString, text:DOMString):void Inserts the given HTML text into the element at the location.	Element
		Non-Standard insertAdjacentText(where:DOMString, text:DOMString):void Inserts the given text into the element at the specified location.	Element
		DOM 1 Core insertBefore(newNode:Node, childNode:Node):Node Inserts the specified node before a reference element as a child of the current node.	Node
		DOM 3 Core isDefaultNamespace(namespaceURI:DOMString):Boolean Returns true if the namespace is the default namespace on the given node or false if not.	Node
		DOM 3 Core isEqualNode(arg:Node):Boolean Tests whether two nodes are equal.	Node
		DOM 3 Core isSameNode(other:Node):Boolean Returns whether this node is the same node as the given one.	Node
		DOM 2 Core isSupported(feature:DOMString, version:DOMString):Boolean Tests whether the DOM implementation implements a specific feature and that feature is supported by this node.	Node
		DOM 3 Core lookupNamespaceURI(prefix:DOMString):DOMString Takes a prefix and returns the namespaceURI associated with it on the given node if found (and null if not).	Node
		DOM 3 Core lookupPrefix(namespaceURI:DOMString):DOMString Returns the prefix for a given namespaceURI if present, and null if not.	Node
		Non-Standard mergeAttributes(source:Element, preserve:Boolean = true):void Copies all read/write attributes to the specified element.	Element
		DOM 1 Core normalize():void Puts the specified node and all of its subtree into a "normalized" form.	Node
		Selectors API querySelector(selectors:DOMString):Element Returns the first element that is a descendent of the element on which it is invoked that matches the specified group of selectors.	Element
		Selectors API querySelectorAll(selectors:DOMString):NodeList Returns a list of all elements descended from the element on which it is invoked that match the specified group of selectors.	Element
		Non-Standard releaseCapture():void Removes mouse capture from the object in the current document.	Element
		remove(index:Number):void Remove an element from the collection of OPTION elements for this SELECT.	HTMLSelectElement
		DOM 1 Core removeAttribute(name:DOMString):void Removes an attribute from the specified element.	Element
		DOM 1 Core removeAttributeNode(name:Attr):Attr Removes an attribute object from the object.	Element
		DOM 2 Core removeAttributeNS(nameSpace:DOMString, name:DOMString):void Removes the specified attribute from an element.	Element
		Non-Standard removeBehavior(id:Number):Boolean Detaches a behavior from the element.	Element
		DOM 1 Core removeChild(node:Node):Node Removes a child node from the object.	Node
		DOM 2 Events removeEventListener(type:DOMString, listener:EventListener, useCapture:Boolean):void Removes an event listener.	Node
		DOM 3 Events removeEventListenerNS(namespaceURI:DOMString, type:DOMString, listener:EventListener, useCapture:Boolean):void Removes an event listener.	Node
		Non-Standard removeExpression(propertyName:DOMString):Boolean Removes the expression from the specified property.	Element
		Non-Standard removeNode(removeChildren:Boolean = false):Node Removes the object from the document hierarchy.	Element
		Non-Standard replaceAdjacentText(where:DOMString, replaceText:DOMString):DOMString Replaces the text adjacent to the element.	Element
		DOM 1 Core replaceChild(newNode:Node, childNode:Node):Node Replaces an existing child element with a new child element.	Node
		Non-Standard replaceNode(newNode:Node):Node Replaces the object with another element.	Element
		DOM 0 scrollIntoView(alignToTop:Boolean = true):void Causes the object to scroll into view, aligning it either at the top or bottom of the window.	Element
		Non-Standard selectNodes(queryString:DOMString):NodeList Applies the specified pattern-matching operation to this node's context and returns the list of matching nodes as IXMLDOMNodeList.	Node
		Non-Standard selectSingleNode(queryString:DOMString):Node Applies the specified pattern-matching operation to this node's context and returns the first matching node.	Node
		Non-Standard setActive():void Sets the object as active without setting focus to the object.	Element
		DOM 1 Core setAttribute(name:DOMString, value:Number, caseSensitive:*):void Sets the value of the specified attribute.	Element
		DOM 1 Core setAttributeNode(attrNode:Attr):Attr Sets an attribute object node as part of the object.	Element
		DOM 2 Core setAttributeNodeNS(attrNode:Attr):void Adds a new attribute node with the specified namespace and name.	Element
		DOM 2 Core setAttributeNS(nameSpace:DOMString, name:DOMString, value:*):void Adds a new attribute or changes the value of an attribute with the given namespace and name.	Element
		Non-Standard setCapture(containerCapture:Boolean = true):void Sets the mouse capture to the object that belongs to the current document.	Element
		Non-Standard setExpression(propertyName:DOMString, expression:DOMString, language:DOMString):void Sets an expression for the specified object.	Element
		DOM 3 Core setIdAttribute(name:DOMString, isId:Boolean):void If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute.	Element
		DOM 3 Core setIdAttributeNode(idAttr:Attr, isId:Boolean):void If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute.	Element
		DOM 3 Core setIdAttributeNS(nameSpaceURI:DOMString, name:DOMString, isId:Boolean):void If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute.	Element
		DOM 3 Core setUserData(key:DOMString, data:DOMUserData, handler:UserDataHandler):DOMUserData Associate an object to a key on this node.	Node
		Non-Standard swapNode(node:Node):Node Exchanges the location of two objects in the document hierarchy.	Element
		Non-Standard transformNode(styleSheet:Node):DOMString Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet and returns the resulting transformation.	Node
		Non-Standard transformNodeToObject(styleSheet:Node, outputObject:*):void Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet and returns the resulting transformation.	Node

Events

Hide Inherited Events

Show Inherited Events

	Summary	Defined By
abort	Loading of a resource has been aborted.	Element
blur	An event target loses focus.	Element
change	A control loses the input focus and its value has been modified since gaining focus.	Element
click	A pointing device button is clicked over an element.	Element
dblclick	A pointing device button is clicked twice over an element.	Element
DOMActivate	Refer to Activation requests and behavior.	Element
DOMAttributeNameChanged	Occurs after the namespaceURI and/or the nodeName of a Attr node have been modified (e.g., the attribute was renamed using Document.renameNode()).	Element
DOMAttrModified	Occurs after Attr.value has been modified and after an Attr node has been added to or removed from an Element.	Element
DOMContentLoaded	Gecko-Specific Fired on a Window object when a document's DOM content is finished loading, but unlike "load", does not wait until all images are loaded.	Element
DOMElementNameChanged	Occurs after the namespaceURI and/or the nodeName of an Element node have been modified (e.g., the element was renamed using Document.renameNode()).	Element
DOMFocusIn	An event target receives focus.	Element
DOMFocusOut	An event target loses focus.	Element
DOMFrameContentLoaded	Gecko-Specific Same as DOMContentLoaded, but also fired for enclosed frames.	Element
DOMLinkAdded	Gecko-Specific Undocumented	Element
DOMLinkRemoved	Gecko-Specific Undocumented	Element
DOMMenuItemActive	Gecko-Specific Undocumented	Element
DOMModalDialogClosed	Gecko-Specific Undocumented	Element
DOMMouseScroll	Gecko-Specific The DOMMouseScroll event is sent when the mouse wheel is moved.	Element
DOMNodeInserted	A node has been added as a child of another node or, in case of Attr nodes, has been added to an Element.	Element
DOMNodeInsertedIntoDocument	A node has been inserted into a document, either through direct insertion of the node or insertion of a subtree in which it is contained; Attr nodes are considered part of an Element's subtree.	Element
DOMNodeRemoved	A node is being removed from its parent node or, in case of Attr nodes, removed from its ownerElement.	Element
DOMNodeRemovedFromDocument	A node is being removed from a document, either through direct removal of the node or removal of a subtree in which it is contained; Attr nodes are considered part of an Element's subtree.	Element
DOMSubtreeModified	This is a general event for notification of all changes to the document.	Element
DOMTitleChanged	Gecko-Specific Undocumented	Element
DOMWillOpenModalDialog	Gecko-Specific Undocumented	Element
DOMWindowClose	Gecko-Specific Fired when the window is about to be closed by window.close().	Element
error	A resource failed to load, or has been loaded but cannot be interpreted according to its semantics such as an invalid image, a script execution error, or non-well-formed XML.	Element
focus	An event target receives focus.	Element
fullscreen	Gecko-Specific Undocumented	Element
keydown	A key is pressed down.	Element
keyup	A key is released.	Element
load	The DOM Implementation finishes loading the resource (such as the document) and any dependent resources (such as images, style sheets, or scripts).	Element
mousedown	A pointing device button is pressed over an element.	Element
mousemove	A pointing device is moved while it is over an element.	Element
mousemultiwheel	A mouse wheel has been rotated.	Element
mouseout	A pointing device is moved away from an element.	Element
mouseover	A pointing device is moved onto an element.	Element
mouseup	A pointing device button is released over an element.	Element
mousewheel	A mouse wheel has been rotated around the y-axis.	Element
MozAfterPaint	Gecko-Specific \| Firefox 3.5+ The MozAfterPaint event is fired whenever content is repainted.	Element
MozMousePixelScroll	Gecko-Specific \| Firefox 3.5+ Regular mouse wheels can only scroll with a per-line resolution.	Element
PluginNotFound	Gecko-Specific Undocumented	Element
PopupWindow	Gecko-Specific Undocumented	Element
reset	A form, such as a [HTML 4.01] or [XHTML 1.0] form, is reset.	Element
resize	A document view or an element has been resized.	Element
scroll	A document view or an element has been scrolled.	Element
select	A user selects some text.	Element
submit	A form, such as a [HTML 4.01] or [XHTML 1.0] form, is submitted.	Element
textInput	One or more characters have been entered.	Element
unload	The DOM implementation removes from the environment the resource (such as the document) or any dependent resources (such as images, style sheets, scripts).	Element
ValueChange	Gecko-Specific Undocumented	Element
windowZLevel	Gecko-Specific Undocumented	Element

	Constant	Defined By
		DOM 1 Core ATTRIBUTE_NODE : Number = 2 [static] The node is an Attr.	Node
		DOM 1 Core CDATA_SECTION_NODE : Number = 4 [static] The node is a CDATASection.	Node
		DOM 1 Core COMMENT_NODE : Number = 8 [static] The node is a Comment.	Node
		DOM 1 Core DOCUMENT_FRAGMENT_NODE : Number = 11 [static] The node is a DocumentFragment.	Node
		DOM 1 Core DOCUMENT_NODE : Number = 9 [static] The node is a Document.	Node
		DOM 3 Core DOCUMENT_POSITION_CONTAINED_BY : Number = 16 [static] The node is contained by the reference node.	Node
		DOM 3 Core DOCUMENT_POSITION_CONTAINS : Number = 8 [static] The node contains the reference node.	Node
		DOM 3 Core DOCUMENT_POSITION_DISCONNECTED : Number = 1 [static] The two nodes are disconnected.	Node
		DOM 3 Core DOCUMENT_POSITION_FOLLOWING : Number = 4 [static] The node follows the reference node.	Node
		DOM 3 Core DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC : Number = 32 [static] The determination of preceding versus following is implementation-specific.	Node
		DOM 3 Core DOCUMENT_POSITION_PRECEDING : Number = 2 [static] The second node precedes the reference node.	Node
		DOM 1 Core DOCUMENT_TYPE_NODE : Number = 10 [static] The node is a DocumentType.	Node
		DOM 1 Core ELEMENT_NODE : Number = 1 [static] The node is an Element.	Node
		DOM 1 Core ENTITY_NODE : Number = 6 [static] The node is an Entity.	Node
		DOM 1 Core ENTITY_REFERENCE_NODE : Number = 5 [static] The node is an EntityReference.	Node
		DOM 1 Core NOTATION_NODE : Number = 12 [static] The node is a Notation.	Node
		DOM 1 Core PROCESSING_INSTRUCTION_NODE : Number = 7 [static] The node is a ProcessingInstruction.	Node
		DOM 1 Core TEXT_NODE : Number = 3 [static] The node is a Text node.	Node

Property Detail

disabled

property

disabled:Boolean

The control is unavailable in this context. See the disabled attribute definition in HTML 4.01.

Implementation
public function get disabled():Boolean
public function set disabled(value:Boolean):void

form

property

form:HTMLFormElement [read-only]

Returns the FORM element containing this control. Returns null if this control is not within the context of a form.

Implementation
public function get form():HTMLFormElement

length

property

length:Number

Modified in DOM Level 2 The number of options in this SELECT.

Implementation
public function get length():Number
public function set length(value:Number):void

Throws

DOMException — NOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.

multiple

property

multiple:Boolean

If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.01.

Implementation
public function get multiple():Boolean
public function set multiple(value:Boolean):void

name

property

name:DOMString

Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01.

Implementation
public function get name():DOMString
public function set name(value:DOMString):void

onblur

property

onblur:Function

The onblur event occurs when an element loses focus either by the pointing device or by tabbing navigation.

Implementation
public function get onblur():Function
public function set onblur(value:Function):void

onchange

property

onchange:Function

The onchange event occurs when a control loses the input focus and its value has been modified since gaining focus.

Implementation
public function get onchange():Function
public function set onchange(value:Function):void

onfocus

property

onfocus:Function

The onfocus event occurs when an element receives focus either by the pointing device or by tabbing navigation.

Implementation
public function get onfocus():Function
public function set onfocus(value:Function):void

options

property

options:HTMLOptionsCollection [read-only]

Modified in DOM Level 2 The collection of OPTION elements contained by this element.

Implementation
public function get options():HTMLOptionsCollection

selectedIndex

property

selectedIndex:Number

The ordinal index of the selected option, starting from 0. The value -1 is returned if no element is selected. If multiple options are selected, the index of the first selected option is returned.

Implementation
public function get selectedIndex():Number
public function set selectedIndex(value:Number):void

size

property

size:Number

Number of visible rows. See the size attribute definition in HTML 4.01.

Implementation
public function get size():Number
public function set size(value:Number):void

tabIndex

property

tabIndex:Number

Gets/sets the tab order of the current element.

Implementation
public function get tabIndex():Number
public function set tabIndex(value:Number):void

type

property

type:DOMString [read-only]

The type of this form control. This is the string "select-multiple" when the multiple attribute is true and the string "select-one" when false.

Implementation
public function get type():DOMString

value

property

value:DOMString

The current form control value (i.e. the value of the currently selected option), if multiple options are selected this is the value of the first selected option.

Implementation
public function get value():DOMString
public function set value(value:DOMString):void

Method Detail

add

()

method

public function add(element:HTMLElement, before:HTMLElement):void

Add a new element to the collection of OPTION elements for this SELECT. This method is the equivalent of the appendChild method of the Node interface if the before parameter is null. It is equivalent to the insertBefore method on the parent of before in all other cases. This method may have no effect if the new element is not an OPTION or an OPTGROUP.

Parameters

	`element:HTMLElement` — The element to add.

	`before:HTMLElement` — The element to insert before, or null for the tail of the list.

Throws

DOMException — NOT_FOUND_ERR: Raised if before is not a descendant of the SELECT element.

blur

()

method

public function blur():void

Causes the element to lose focus and fires the onblur event. This method shifts focus away from the element it is applied to but does not set focus on the next element in the tab order. IE In Microsoft Internet Explorer 5 and greater, elements that expose the blur method must have the TABINDEX attribute set.

focus

()

method

public function focus():void

Causes the element to receive the focus and executes the code specified by the onfocus event. This method fires the onfocus event. As of Microsoft Internet Explorer 5, elements that expose the focus method must have the TABINDEX attribute set. Elements cannot receive focus until the document finishes loading.

remove

()

method

public function remove(index:Number):void

Remove an element from the collection of OPTION elements for this SELECT. Does nothing if no element has the given index.

Parameters

index:Number — The index of the item to remove, starting from 0.

Mon Aug 17 2009, 10:08 AM -04:00

DOM Reference Manual		All Packages \| All Classes \| Index \| Frames No Frames
HTMLSelectElement	Properties \| Methods \| Events \| Constants

Package	dom.html
Class	public class HTMLSelectElement
Inheritance	HTMLSelectElement HTMLElement Element Node Object