class js.html.SelectElement extends Element

Available on js

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).

Documentation for this class was provided by MDN.

Instance Fields

var autofocus:Bool

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 Requires Gecko 2.0

var disabled:Bool

Reflects the

disabled HTML attribute, which indicates whether the control is disabled. If it is disabled, it does not accept clicks.

var form:FormElement

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.

var labels:NodeList

A list of label elements associated with this select element.

var length:Int

The number of <option> elements in this select element. Setter throws DOMException.

var multiple:Bool

Reflects the

multiple HTML attribute, whichindicates whether multiple items can be selected.

var name:String

Reflects the

name HTML attribute, containing the name of this control used by servers and DOM search functions.

var options:HTMLOptionsCollection

The set of <option> elements contained by this element. Read only.

var required:Bool

Reflects the

required HTML attribute, which indicates whether the user is required to select a value before submitting the form. HTML5 Requires Gecko 2.0

var selectedIndex:Int

The index of the first selected <option> element.

var selectedOptions:HTMLCollection

The set of options that are selected. HTML5

var size:Int

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.

var type:String

The form control's type. When multiple is true, it returns select-multiple; otherwise, it returns select-one.Read only.

var validationMessage:String

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 <span title="(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) ">Requires Gecko 2.0

var validity:ValidityState

The validity states that this control is in. Read only. HTML5 <span title="(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) ">Requires Gecko 2.0

var value:String

The value of this form control, that is, of the first selected option.

var willValidate:Bool

Indicates whether the button is a candidate for constraint validation. It is false if any conditions bar it from constraint validation. Read only. HTML5 <span title="(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) ">Requires Gecko 2.0

function add(element:Element, before:Element):Void

function checkValidity():Bool

function item(index:Int):Node

function namedItem(name:String):Node

function setCustomValidity(error:String):Void