select – option-selection form control

Permitted contents #

zero or more optgroup elements, intermixed with zero or more option elements

Permitted attributes #

global attributes & name & disabled & form & size & multiple & autofocus & required

ⓘ global attributes: Any attributes permitted globally.
ⓘ name = string #: The name part of the name/value pair associated with this element for the purposes of form submission.
ⓘ disabled = d:string "disabled" or d:string "" #: Specifies that the element represents a disabled control.
ⓘ form = ID reference NEW #: The value of the id attribute on the form with which to associate the element.
ⓘ size = positive integer #: The number of options to show to the user.
ⓘ multiple = d:string "multiple" or d:string "" #: If present, indicates that its select element represents a control for selecting zero or more options from a list of options.; If not present, indicates that its select element represents a control for selecting a single option from a list of options.
ⓘ autofocus = d:string "autofocus" or d:string "" NEW #: Specifies that the element represents a control to which a UA is meant to give focus as soon as the document is loaded.
ⓘ required = d:string "required" or d:string "" NEW #: Specifies that the element is a required part of form submission.

Additional constraints and admonitions #

The interactive element “select” must not appear as a descendant of the “a” element.
The interactive element “select” must not appear as a descendant of the “button” element.
Any “select” element descendant of a “label” element with a “for” attribute must have an ID value that matches that “for” attribute.
The “select” element cannot have more than one selected “option” element descendant unless the “multiple” attribute is specified.
A “select” element with a “required” attribute and without a “multiple” attribute, and whose size is “1”, must have a child “option” element.
The first child “option” element of a “select” element with a “required” attribute and without a “multiple” attribute, and whose size is “1”, must have either an empty “value” attribute, or must have no text content.

Tag omission #

A select element must have both a start tag and an end tag.

Permitted parent elements #

any element that can contain phrasing elements

DOM interface #

interface HTMLSelectElement : HTMLElement {
           attribute boolean autofocus;
           attribute boolean disabled;
  readonly attribute HTMLFormElement? form;
           attribute boolean multiple;
           attribute DOMString name;
           attribute boolean required;
           attribute unsigned long size;

  readonly attribute DOMString type;

  readonly attribute HTMLOptionsCollection options;
           attribute unsigned long length;
  getter Element item(unsigned long index);
  object namedItem(DOMString name);
  void add((HTMLOptionElement or HTMLOptGroupElement) element, optional (HTMLElement or long)? before = null);
  void remove(long index);
  setter creator void (unsigned long index, HTMLOptionElement option);

  readonly attribute HTMLCollection selectedOptions;
           attribute long selectedIndex;
           attribute DOMString value;

  readonly attribute boolean willValidate;
  readonly attribute ValidityState validity;
  readonly attribute DOMString validationMessage;
  boolean checkValidity();
  void setCustomValidity(DOMString error);

  readonly attribute NodeList labels;
};

HTML 5: The Markup Language (ARIA Edition)

ⓘ select – option-selection form control # T

Permitted contents #

Permitted attributes #

Additional constraints and admonitions #

Tag omission #

Permitted parent elements #

DOM interface #