CKTIS / HTML
option — eine HTML-Auswahloption
Das Element option definiert eine Auswahl in select oder einen Vorschlag in datalist. Es trennt die Beschriftung vom Wert und unterstützt eine Vorauswahl sowie deaktivierte Optionen.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<option value="value" selected disabled>Label</option>option stellt eine Auswahl in select oder einen Vorschlag in datalist dar; optgroup gruppiert Optionen. Ein Vorschlag allein beschränkt die eingegebene Texteingabe nicht auf die verfügbaren Werte.
value legt den Wert der Option fest; fehlt das Attribut, wird der Wert aus ihrem Text abgeleitet. Ein nicht leeres label legt die Beschriftung fest; andernfalls stammt sie aus dem Textinhalt. Für eine herkömmliche Liste genügt einfacher Text.
Das boolesche Attribut selected legt die Vorauswahl fest und wird durch defaultSelected widergespiegelt. Die JavaScript-Eigenschaft selected gibt den aktuellen Zustand an. Ohne multiple an select sollte nicht mehr als eine Option das Attribut selected haben.
disabled verhindert die Auswahl durch den Nutzer, auch wenn die Deaktivierung von einem übergeordneten optgroup stammt; programmatische Änderungen werden dadurch nicht verhindert. Im Beispiel lautet die angezeigte Beschriftung Medium, der Wert hingegen m.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Option example</title>
<label for="size">Size</label>
<select id="size" name="size">
<option value="s">Small</option>
<option value="m" selected>Medium</option>
<option value="l" disabled>Large</option>
</select>
<pre id="result"></pre>
<script>
const select = document.getElementById('size');
const option = select.options[1];
document.getElementById('result').textContent =
`${select.value}\n${option.text}\n${option.selected}\n${option.defaultSelected}`;
</script>
</html>Ergebnis
m Medium 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.