WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

select — Auswahlsteuerelement

Mit dem Element `select` können Nutzerinnen und Nutzer aus Formularoptionen auswählen. Erfahre mehr über Einfach- und Mehrfachauswahl, Beschriftungen und die Rolle von `name` beim Übermitteln von Daten.

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

Syntax

<select name="field" id="field"><option value="value">Label</option></select>

select bietet eine Auswahl aus option-Elementen. Ohne multiple ist nur eine Auswahl möglich; mit multiple können null oder mehr Optionen ausgewählt werden. size legt fest, wie viele Einträge sichtbar sind.

Verknüpfe ein label mit dem Steuerelement, indem die Werte von for und id übereinstimmen. name ist der Schlüssel in den Formulardaten, während id das Steuerelement identifiziert und nicht als Übermittlungsschlüssel dient. Jede ausgewählte, aktivierte Option trägt ihren Wert bei; bei multiple kann der Schlüssel mehrfach vorkommen. Ein Steuerelement mit disabled wird ausgelassen.

Bei einer erforderlichen Einfachauswahl mit einer Anzeigegröße von 1 muss die erste Option als Platzhalter dienen: Sie muss einen leeren Wert haben und ein direktes Kind von select sein, nicht von optgroup oder einem anderen Element. Nur diese Option auszuwählen erfüllt required nicht.

Im Beispiel ist anfangs die Option dark ausgewählt. Das Skript liest die Formulardaten aus, ohne sie an einen Server zu senden. Das Ergebnis zeigt den Anfangszustand und wird bei einer Änderung der Auswahl nicht aktualisiert.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Select example</title>
<form id="settings">
  <label for="theme">Theme</label>
  <select id="theme" name="theme" required>
    <option value="">Choose a theme</option>
    <option value="light">Light</option>
    <option value="dark" selected>Dark</option>
  </select>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('settings');
  const data = new FormData(form);
  document.getElementById('result').textContent = data.get('theme');
</script>
</html>

Ergebnis

dark

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