HTMLOptionElement: Option() Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Der Option() Konstruktor erzeugt ein neues HTMLOptionElement.

Syntax

js
new Option()
new Option(text)
new Option(text, value)
new Option(text, value, defaultSelected)
new Option(text, value, defaultSelected, selected)

Parameter

text Optional

Ein String, der den Inhalt des Elements repräsentiert, d.h. den angezeigten Text. Falls dieser nicht angegeben ist, wird ein Standardwert von "" (leerer String) verwendet.

value Optional

Ein String, der den Wert des HTMLOptionElement repräsentiert, d.h. das value-Attribut des entsprechenden <option>. Falls dieser nicht angegeben ist, wird der Wert von text als Wert verwendet, z.B. für den Wert des zugehörigen <select>-Elements, wenn das Formular zum Server gesendet wird.

defaultSelected Optional

Ein Wert entweder true oder false, der den Wert des selected-Attributs setzt, um dieses <option> als Standardwert im <select>-Element auszuwählen, wenn die Seite erstmals geladen wird. Falls dieser nicht angegeben ist, wird ein Standardwert von false verwendet. Beachten Sie, dass ein Wert von true die Option nicht auswählt, wenn sie nicht bereits ausgewählt ist.

selected Optional

Ein Wert entweder true oder false, der den ausgewählten Zustand der Option setzt; der Standardwert ist false (nicht ausgewählt). Wenn weggelassen, wird die Option auch dann nicht ausgewählt, wenn das Argument defaultSelected true ist.

Beispiele

Einfach neue Optionen hinzufügen

js
/* assuming we have the following HTML
<select id='s'>

</select>
*/

const s = document.getElementById("s");
const options = [Four, Five, Six];

options.forEach((element, key) => {
  s[key] = new Option(element, key);
});

Optionen mit unterschiedlichen Parametern anhängen

js
/* assuming we have the following HTML
<select id="s">
    <option>First</option>
    <option>Second</option>
    <option>Third</option>
</select>
*/

const s = document.getElementById("s");
const options = ["zero", "one", "two"];

options.forEach((element, key) => {
  if (element === "zero") {
    s[key] = new Option(element, s.options.length, false, false);
  }
  if (element === "one") {
    s[key] = new Option(element, s.options.length, true, false); // Will add the "selected" attribute
  }
  if (element === "two") {
    s[key] = new Option(element, s.options.length, false, true); // Just will be selected in "view"
  }
});

/* Result
<select id="s">
  <option value="0">zero</option>
  <option value="1" selected="">one</option>
  <option value="2">two</option> // User will see this as 'selected'
</select>
*/

Spezifikationen

Specification
HTML
# dom-option-dev

Browser-Kompatibilität