WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

selected — standardmäßige Auswahl einer Option

Das boolesche Attribut selected legt fest, ob ein option-Element standardmäßig ausgewählt ist. Es ist kein zuverlässiger Hinweis auf die aktuelle Auswahl: In JavaScript beschreibt selected den aktuellen Zustand, während defaultSelected das Attribut widerspiegelt.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<option selected>...</option>
<option selected="">...</option>
<option selected="selected">...</option>

selected ist ein boolesches Attribut eines option-Elements, das dessen standardmäßige Auswahl festlegt. Es gehört auf option, nicht auf select. Ohne multiple darf ein select nicht mehr als eine Option mit diesem Attribut enthalten; mit multiple sind mehrere standardmäßige Auswahlen möglich.

Die Schreibweisen selected, selected="" und selected="selected" sind gleichwertig. selected="false" ist ungültig und bedeutet trotzdem, dass das Attribut vorhanden ist. Um die standardmäßige Auswahl zu entfernen, lasse das Attribut weg oder entferne es.

In JavaScript spiegelt option.defaultSelected das Attribut wider, während option.selected die aktuelle Auswahl angibt. Eine Änderung der Auswahl durch den Benutzer oder eine Zuweisung an option.selected setzt intern ein Dirtiness-Flag; danach steuert eine Änderung des Attributs die Auswahl dieser Option nicht mehr direkt. Verwende option.selected oder select.value, um die aktuelle Auswahl zu ändern.

form.reset() stellt die Auswahl anhand der aktuellen selected-Attribute wieder her, setzt die Dirtiness-Flags zurück und wendet die Auswahlregeln des select-Elements an. Ein fehlendes Attribut garantiert nicht, dass aktuell nichts ausgewählt ist: Ein gewöhnliches Dropdown kann automatisch seine erste aktivierte Option auswählen.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>selected</title>
<form id="demo">
  <label for="color">Color</label>
  <select id="color" name="color">
    <option value="red">Red</option>
    <option value="blue" selected>Blue</option>
  </select>
</form>
<pre id="output"></pre>
<script>
  const form = document.getElementById('demo');
  const select = document.getElementById('color');
  const blue = select.options[1];
  const lines = [];
  function record() {
    lines.push(`${select.value} ${blue.selected} ${blue.defaultSelected}`);
  }
  record();
  select.value = 'red';
  record();
  form.reset();
  record();
  document.getElementById('output').textContent = lines.join('\n');
</script>

Ergebnis

blue true true
red false true
blue true true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen