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 erstellt 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. Wenn dieser nicht angegeben wird, 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>. Wenn dieser nicht angegeben wird, wird der Wert von text als Wert verwendet, z.B. für den Wert des zugehörigen <select>-Elements, wenn das Formular an den Server übermittelt wird.

defaultSelected Optional

Ein Wert entweder true oder false, der den Wert des selected Attributs festlegt, d.h. dass diese <option> der standardmäßig ausgewählte Wert im <select>-Element ist, wenn die Seite erstmals geladen wird. Wenn dieser nicht angegeben wird, wird ein Standardwert von false verwendet. Beachten Sie, dass ein Wert von true die Option nicht auf ausgewählt setzt, wenn sie nicht bereits ausgewählt ist.

selected Optional

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

Beispiele

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 verschiedenen Parametern hinzufügen

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 Standard
# dom-option-dev

Browser-Kompatibilität

BCD tables only load in the browser