HTMLSelectElement
Related Doc:
package raw
Adds an element to the collection of option elements for this select element.
Adds an element to the collection of option elements for this select element.
MDN
The EventTarget.addEventListener() method registers the specified listener on the EventTarget it's called on.
The EventTarget.addEventListener() method registers the specified listener on the EventTarget it's called on. The event target may be an Element in a document, the Document itself, a Window, or any other object that supports events (such as XMLHttpRequest).
MDN
Adds a node to the end of the list of children of a specified parent node.
Adds a node to the end of the list of children of a specified parent node. If the node already exists it is removed from current parent node, then added to new parent node.
MDN
.attributes is a collection of all attribute nodes registered to the specified node.
.attributes is a collection of all attribute nodes registered to the specified node. It is a NamedNodeMap,not an Array, so it has no Array methods and the Attr nodes' indexes may differ among browsers. To be more specific, attribute is a key value pair of strings that represents any information regarding that node; it cannot hold Object. Attribute can hold additional data/information that is required while processing custom JavaScript. There are many predefined attributes for different nodes used for binding events, validations, and specifying layout informations that are handled by browser (may vary from browser to browser).
MDN
Reflects the autofocus HTML attribute, which indicates whether the control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control.
Reflects the autofocus HTML attribute, which indicates whether the control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control. Only one form-associated element in a document can have this attribute specified. HTML5
MDN
The blur method removes keyboard focus from the current element.
The blur method removes keyboard focus from the current element.
MDN
Returns an unsigned long giving the amount of children that the object has.
Returns an unsigned long giving the amount of children that the object has.
MDN
Returns a live NodeList containing all the children of this node.
Returns a live NodeList containing all the children of this node. NodeList being live means that if the children of the Node change, the NodeList object is automatically updated.
MDN
Returns a live HTMLCollection containing all objects of type Element that are children of the object.
Returns a live HTMLCollection containing all objects of type Element that are children of the object.
MDN
Supported by FF>3.6, any Opera, any Chrome, any IE, any Safari
Supported by FF>3.6, any Opera, any Chrome, any IE, any Safari
The click method simulates a mouse click on an element.
The click method simulates a mouse click on an element.
MDN
Returns the inner height of an element in pixels, including padding but not the horizontal scrollbar height, border, or margin.
Returns the inner height of an element in pixels, including padding but not the horizontal scrollbar height, border, or margin.
clientHeight can be calculated as CSS height + CSS padding - height of horizontal scrollbar (if present).
MDN
The width of the left border of an element in pixels.
The width of the left border of an element in pixels. It includes the width of the vertical scrollbar if the text direction of the element is right–to–left and if there is an overflow causing a left vertical scrollbar to be rendered. clientLeft does not include the left margin or the left padding. clientLeft is read-only.
MDN
The width of the top border of an element in pixels.
The width of the top border of an element in pixels. It does not include the top margin or padding. clientTop is read-only.
MDN
clientWidth is the inner width of an element in pixels.
clientWidth is the inner width of an element in pixels. It includes padding but not the vertical scrollbar (if present, if rendered), border or margin.
MDN
Clone a Node, and optionally, all of its contents.
Clone a Node, and optionally, all of its contents. By default, it clones the content of the node.
MDN
Compares the position of the current node against another node in any other document.
Compares the position of the current node against another node in any other document.
MDN
Returns a Boolean value indicating whether a node is a descendant of a given node, i.e.
Returns a Boolean value indicating whether a node is a descendant of a given node, i.e. the node itself, one of its direct children (childNodes), one of the children's direct children, and so on.
MDN
contentEditable is used to indicate whether or not the element is editable.
contentEditable is used to indicate whether or not the element is editable. This enumerated attribute can have the following values:
MDN
The dir attribute gets or sets the text writing directionality of the content of the current element.
The dir attribute gets or sets the text writing directionality of the content of the current element.
MDN
Reflects the disabled HTML attribute, which indicates whether the control is disabled.
Reflects the disabled HTML attribute, which indicates whether the control is disabled. If it is disabled, it does not accept clicks.
MDN
Dispatches an Event at the specified EventTarget, invoking the affected EventListeners in the appropriate order.
Dispatches an Event at the specified EventTarget, invoking the affected EventListeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) apply to events dispatched manually with dispatchEvent().
MDN
Returns the node's first child in the tree, or null if the node is childless.
Returns the node's first child in the tree, or null if the node is childless. If the node is a Document, it returns the first node in the list of its direct children.
MDN
Returns the Element that is the first child of the object, or null if there is none.
Returns the Element that is the first child of the object, or null if there is none.
MDN
Sets focus on the specified element, if it can be focused.
Sets focus on the specified element, if it can be focused.
MDN
The form that this element is associated with.
The form that this element is associated with. If this element is a descendant of a form element, then this attribute is the ID of that form element. If the element is not a descendant of a form element, then: HTML5 The attribute can be the ID of any form element in the same document. HTML 4 The attribute is null. Read only.
MDN
getAttribute() returns the value of the named attribute on the specified element.
getAttribute() returns the value of the named attribute on the specified element. If the named attribute does not exist, the value returned will either be null or "" (the empty string); see Notes for details.
MDN
getAttributeNS returns the string value of the attribute with the specified namespace and name.
getAttributeNS returns the string value of the attribute with the specified namespace and name. If the named attribute does not exist, the value returned will either be null or "" (the empty string); see Notes for details.
MDN
Returns the specified attribute of the specified element, as an Attr node.
Returns the specified attribute of the specified element, as an Attr node.
MDN
Returns the Attr node for the attribute with the given namespace and name.
Returns the Attr node for the attribute with the given namespace and name.
MDN
Returns a text rectangle object that encloses a group of text rectangles.
Returns a text rectangle object that encloses a group of text rectangles.
MDN
Returns a collection of rectangles that indicate the bounding rectangles for each box in a client.
Returns a collection of rectangles that indicate the bounding rectangles for each box in a client.
MDN
Returns an array-like object of all child elements which have all of the given class names.
Returns an array-like object of all child elements which have all of the given class names. When called on the document object, the complete document is searched, including the root node. You may also call getElementsByClassName() on any element; it will return only elements which are descendants of the specified root element with the given class names.
MDN
Returns a list of elements with the given tag name.
Returns a list of elements with the given tag name. The subtree underneath the specified element is searched, excluding the element itself. The returned list is live, meaning that it updates itself with the DOM tree automatically. Consequently, there is no need to call several times element.getElementsByTagName with the same element and arguments.
MDN
Returns a list of elements with the given tag name belonging to the given namespace.
Returns a list of elements with the given tag name belonging to the given namespace.
MDN
fired when an element receives pointer capture.
fired when an element receives pointer capture.
MDN
hasAttribute returns a boolean value indicating whether the specified element has the specified attribute or not.
hasAttribute returns a boolean value indicating whether the specified element has the specified attribute or not.
MDN
hasAttributeNS returns a boolean value indicating whether the current element has the specified attribute.
hasAttributeNS returns a boolean value indicating whether the current element has the specified attribute.
MDN
hasAttributes returns a boolean value of true or false, indicating if the current element has any attributes or not.
hasAttributes returns a boolean value of true or false, indicating if the current element has any attributes or not.
MDN
hasChildNodes returns a Boolean value indicating whether the current Node has child nodes or not.
hasChildNodes returns a Boolean value indicating whether the current Node has child nodes or not.
MDN
innerHTML sets or gets the HTML syntax describing the element's descendants.
innerHTML sets or gets the HTML syntax describing the element's descendants.
Note: If a <div>, <span>, or <noembed> node has a child text node that includes the characters (&), (<), or (>), innerHTML returns these characters as &, < and > respectively. Use Node.textContent to get a correct copy of these text nodes' contents.
Supported by FF>8, Opera>7, Chrome>1, IE>4, Safari>4
Supported by FF>8, Opera>7, Chrome>1, IE>4, Safari>4
Inserts the first Node given in a parameter immediately before the second, child of this element, Node.
Inserts the first Node given in a parameter immediately before the second, child of this element, Node.
MDN
isContentEditable returns true if the contents of the element are editable; otherwise it returns false.
isContentEditable returns true if the contents of the element are editable; otherwise it returns false.
MDN
isDefaultNamespace accepts a namespace URI as an argument and returns true if the namespace is the default namespace on the given node or false if not.
isDefaultNamespace accepts a namespace URI as an argument and returns true if the namespace is the default namespace on the given node or false if not.
MDN
If #targetElm is first div element in document, "true" will be displayed.
If #targetElm is first div element in document, "true" will be displayed.
MDN
Tests whether two nodes are the same, that is they reference the same object.
Tests whether two nodes are the same, that is they reference the same object.
MDN
The Node.isSupported()returns a Boolean flag containing the result of a test whether the DOM implementation implements a specific feature and this feature is supported by the specific node.
The Node.isSupported()returns a Boolean flag containing the result of a test whether the DOM implementation implements a specific feature and this feature is supported by the specific node.
MDN
This property gets or sets the base language of an element's attribute values and text content.
This property gets or sets the base language of an element's attribute values and text content.
MDN
Returns a Node representing the last direct child node of the node, or null if the node has no child.
Returns a Node representing the last direct child node of the node, or null if the node has no child.
MDN
Returns the Element that is the last child of the object, or null if there is none.
Returns the Element that is the last child of the object, or null if there is none.
MDN
The number of <option> elements in this select element.
The number of <option> elements in this select element.
MDN
Returns a DOMString representing the local part of the qualified name of an element.
Returns a DOMString representing the local part of the qualified name of an element. In Firefox 3.5 and earlier, the property upper-cases the local name for HTML elements (but not XHTML elements). In later versions, this does not happen, so the property is in lower case for both HTML and XHTML. Though the specification requires localName to be defined on the Node interface, Gecko-based browsers implement it on the Element interface.
MDN
Takes a prefix and returns the namespaceURI associated with it on the given node if found (and null if not).
Takes a prefix and returns the namespaceURI associated with it on the given node if found (and null if not). Supplying null for the prefix will return the default namespace.
MDN
Returns the prefix for a given namespaceURI if present, and null if not.
Returns the prefix for a given namespaceURI if present, and null if not. When multiple prefixes are possible, the result is implementation-dependent.
MDN
Fired after pointer capture is released for a pointer.
Fired after pointer capture is released for a pointer.
MDN
Reflects the multiple HTML attribute, whichindicates whether multiple items can be selected.
Reflects the multiple HTML attribute, whichindicates whether multiple items can be selected.
MDN
Reflects the name HTML attribute, containing the name of this control used by servers and DOM search functions.
Reflects the name HTML attribute, containing the name of this control used by servers and DOM search functions.
MDN
The namespace URI of this node, or null if it is no namespace.
The namespace URI of this node, or null if it is no namespace. In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in the http://www.w3.org/1999/xhtml namespace in both HTML and XML trees. Though the specification requires namespaceURI to be defined on the Node interface, Gecko-based browsers implement it on the Element interface.
MDN
The nextElementSibling read-only property returns the element immediately following the specified one in its parent's children list, or null if the specified element is the last one in the list.
The nextElementSibling read-only property returns the element immediately following the specified one in its parent's children list, or null if the specified element is the last one in the list.
MDN
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.
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.
MDN
Returns a DOMString containing the name of the Node.
Returns a DOMString containing the name of the Node. The structure of the name will differ with the name type. E.g. An HTMLElement will contain the name of the corresponding tag, like 'audio' for an HTMLAudioElement, a Text node will have the '#text' string, or a Document node will have the '#document' string.
MDN
The read-only Node.nodeType property returns an unsigned short integer representing the type of the node.
The read-only Node.nodeType property returns an unsigned short integer representing the type of the node.
MDN
Is a DOMString representing the value of an object.
Is a DOMString representing the value of an object. For most Node type, this returns null and any set operation is ignored. For nodes of type TEXT_NODE (Text objects), COMMENT_NODE (Comment objects), and PROCESSING_INSTRUCTION_NODE (ProcessingInstruction objects), the value corresponds to the text data contained in the object.
MDN
Puts the specified node and all of its subtree into a "normalized" form.
Puts the specified node and all of its subtree into a "normalized" form. In a normalized subtree, no text nodes in the subtree are empty and there are no adjacent text nodes.
MDN
Height of an element relative to the element's offsetParent.
Height of an element relative to the element's offsetParent.
MDN
Returns the number of pixels that the upper left corner of the current element is offset to the left within the offsetParent node.
Returns the number of pixels that the upper left corner of the current element is offset to the left within the offsetParent node.
MDN
offsetParent returns a reference to the object which is the closest (nearest in the containment hierarchy) positioned containing element.
offsetParent returns a reference to the object which is the closest (nearest in the containment hierarchy) positioned containing element. If the element is non-positioned, the nearest table cell or root element (html in standards compliant mode; body in quirks rendering mode) is the offsetParent. offsetParent returns null when the element has style.display set to "none". The offsetParent is useful because offsetTop and offsetLeft are relative to its padding edge.
MDN
offsetTop returns the distance of the current element relative to the top of the offsetParent node.
offsetTop returns the distance of the current element relative to the top of the offsetParent node.
MDN
Returns the layout width of an element.
Returns the layout width of an element.
MDN
The copy event is fired when the user initiates a copy action through the
browser UI (for example, using the CTRL/Cmd+C keyboard shortcut or
selecting the "Copy" from the menu) and in response to an allowed
document.execCommand("copy") call.
The copy event is fired when the user initiates a copy action through the
browser UI (for example, using the CTRL/Cmd+C keyboard shortcut or
selecting the "Copy" from the menu) and in response to an allowed
document.execCommand("copy") call.
MDN
The cut event is fired when a selection has been removed from the document and added to the clipboard.
The cut event is fired when a selection has been removed from the document and added to the clipboard.
MDN
The ParentNode.children read-only property returns a live HTMLCollection of child elements of the given object.
The ParentNode.children read-only property returns a live HTMLCollection of child elements of the given object.
The items in the returned collection are objects and not strings. To get data from those node objects, you must use their properties (e.g. elementNodeReference.children[1].nodeName to get the name, etc.).
MDN
The paste event is fired when a selection has been pasted from the clipboard to the document.
The paste event is fired when a selection has been pasted from the clipboard to the document.
MDN
a browser fires this event if it concludes the pointer will no longer be able to generate events (for example the related device is deactived).
a browser fires this event if it concludes the pointer will no longer be able to generate events (for example the related device is deactived).
MDN
fired when a pointer becomes active.
fired when a pointer becomes active.
MDN
fired when a pointing device is moved into the hit test boundaries of an element or one of its descendants, including as a result of a pointerdown event from a device that does not support hover (see pointerdown).
fired when a pointing device is moved into the hit test boundaries of an element or one of its descendants, including as a result of a pointerdown event from a device that does not support hover (see pointerdown).
MDN
fired when a pointing device is moved out of the hit test boundaries of an element.
fired when a pointing device is moved out of the hit test boundaries of an element. For pen devices, this event is fired when the stylus leaves the hover range detectable by the digitizer.
MDN
fired when a pointer changes coordinates.
fired when a pointer changes coordinates.
MDN
fired for several reasons including: pointing device is moved out of the hit test boundaries of an element; firing the pointerup event for a device that does not support hover (see pointerup); after firing the pointercancel event (see pointercancel); when a pen stylus leaves the hover range detectable by the digitizer.
fired for several reasons including: pointing device is moved out of the hit test boundaries of an element; firing the pointerup event for a device that does not support hover (see pointerup); after firing the pointercancel event (see pointercancel); when a pen stylus leaves the hover range detectable by the digitizer.
MDN
fired when a pointing device is moved into an element's hit test boundaries.
fired when a pointing device is moved into an element's hit test boundaries.
MDN
fired when a pointer is no longer active.
fired when a pointer is no longer active.
MDN
The set of <option> elements contained by this element.
The set of <option> elements contained by this element. Read only.
MDN
Gets the markup of the element including its content.
Gets the markup of the element including its content. When used as a setter, replaces the element with nodes parsed from the given string.
Supported by FF>10, any Opera, any Chrome, any IE, any Safari
Returns the Document that this node belongs to.
Returns the Document that this node belongs to. If no document is associated with it, returns null.
MDN
This is defined on Node; we override it here because we know (from the fact that this is an HTMLElement) that we are getting an HTMLDocument here.
Returns a Node that is the parent of this node.
Returns a Node that is the parent of this node. If there is no such node, like if this node is the top of the tree or if doesn't participate in a tree, this property returns null.
MDN
A DOMString representing the namespace prefix of the element, or null if no prefix is specified.
The previousElementSibling read-only property returns the Element immediately prior to the specified one in its parent's children list, or null if the specified element is the first one in the list.
The previousElementSibling read-only property returns the Element immediately prior to the specified one in its parent's children list, or null if the specified element is the first one in the list.
MDN
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.
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.
MDN
Returns the first element within the document (using depth-first pre-order traversal of the document's nodes) that matches the specified group of selectors.
Returns the first element within the document (using depth-first pre-order traversal of the document's nodes) that matches the specified group of selectors.
MDN
Returns a list of the elements within the document (using depth-first pre-order traversal of the document's nodes) that match the specified group of selectors.
Returns a list of the elements within the document (using depth-first pre-order traversal of the document's nodes) that match the specified group of selectors.
MDN
Removes the element at the specified index from the options collection for this select element.
Removes the element at the specified index from the options collection for this select element.
MDN
removeAttribute removes an attribute from the specified element.
removeAttribute removes an attribute from the specified element.
MDN
removeAttributeNS removes the specified attribute from an element.
removeAttributeNS removes the specified attribute from an element.
MDN
removeAttributeNode removes the specified attribute from the current element.
removeAttributeNode removes the specified attribute from the current element.
MDN
Removes a child node from the current element, which must be a child of the current node.
Removes a child node from the current element, which must be a child of the current node.
MDN
Removes the event listener previously registered with EventTarget.addEventListener.
Removes the event listener previously registered with EventTarget.addEventListener.
MDN
Replaces one child Node of the current one with the second one given in parameter.
Replaces one child Node of the current one with the second one given in parameter.
MDN
Reflects the required HTML attribute, which indicates whether the user is required to select a value before submitting the form.
Reflects the required HTML attribute, which indicates whether the user is required to select a value before submitting the form. HTML5
MDN
Height of the scroll view of an element; it includes the element padding but not its margin.
Height of the scroll view of an element; it includes the element padding but not its margin.
MDN
scrollLeft gets or sets the number of pixels that an element's content is scrolled to the left.
scrollLeft gets or sets the number of pixels that an element's content is scrolled to the left.
MDN
scrollTop gets or sets the number of pixels that the content of an element is scrolled upward.
scrollTop gets or sets the number of pixels that the content of an element is scrolled upward.
MDN
scrollWidth is a read–only property that returns either the width in pixels of the content of an element or the width of the element itself, whichever is greater.
scrollWidth is a read–only property that returns either the width in pixels of the content of an element or the width of the element itself, whichever is greater. If the element is wider than its content area (for example, if there are scroll bars for scrolling through the content), the scrollWidth is larger than the clientWidth.
MDN
The index of the first selected <option> element.
The index of the first selected <option> element.
MDN
Adds a new attribute or changes the value of an existing attribute on the specified element.
Adds a new attribute or changes the value of an existing attribute on the specified element.
MSN
setAttributeNS adds a new attribute or changes the value of an attribute with the given namespace and name.
setAttributeNS adds a new attribute or changes the value of an attribute with the given namespace and name.
MDN
setAttributeNode() adds a new Attr node to the specified element.
setAttributeNode() adds a new Attr node to the specified element.
MDN
setAttributeNodeNS adds a new namespaced attribute node to an element.
setAttributeNodeNS adds a new namespaced attribute node to an element.
MDN
Reflects the size HTML attribute, which contains the number of visible items in the control.
Reflects the size HTML attribute, which contains the number of visible items in the control. The default is 1, HTML5 unless multiple is true, in which case it is 4.
MDN
Returns an object that represents the element's style attribute.
Returns an object that represents the element's style attribute.
MDN
Gets/sets the tab order of the current element.
Gets/sets the tab order of the current element.
The tabindex global attribute is an integer indicating if the element can take input focus (is focusable), if it should participate to sequential keyboard navigation, and if so, at what position. It can take several values:
An element with a 0 value, an invalid value, or no tabindex value should be placed after elements with a positive tabindex in the sequential keyboard navigation order.
MDN
In XML (and XML-based languages such as XHTML), tagName preserves case.
In XML (and XML-based languages such as XHTML), tagName preserves case. On HTML elements in DOM trees flagged as HTML documents, tagName returns the element name in the uppercase form. The value of tagName is the same as that of nodeName.
MDN
Is a DOMString representing the textual content of an element and all its descendants.
Is a DOMString representing the textual content of an element and all its descendants.
MDN
Establishes the text to be displayed in a 'tool tip' popup when the mouse is over the displayed node.
Establishes the text to be displayed in a 'tool tip' popup when the mouse is over the displayed node.
MDN
A localized message that describes the validation constraints that the control does not satisfy (if any).
A localized message that describes the validation constraints that the control does not satisfy (if any). This attribute is the empty string if the control is not a candidate for constraint validation (willValidate is false), or it satisfies its constraints. Read only. HTML5
MDN
The validity states that this control is in.
The validity states that this control is in. Read only. HTML5
MDN
The value of this form control, that is, of the first selected option.
The value of this form control, that is, of the first selected option.
MDN
Indicates whether the button is a candidate for constraint validation.
Indicates whether the button is a candidate for constraint validation. It is false if any conditions bar it from constraint validation. Read only. HTML5
MDN
DOM select elements share all of the properties and methods of other HTML elements described in the element section. They also have the specialized interface HTMLSelectElement (or HTML 4 HTMLSelectElement).
MDN