WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

multiple — mehrere Werte in einem Formularsteuerelement

Das boolesche Attribut `multiple` erlaubt mehrere Optionen in `select`, mehrere Adressen in einem `email`-Eingabefeld oder mehrere Dateien in einem `file`-Eingabefeld. Entscheidend ist, ob das Attribut vorhanden ist, nicht der Text seines Werts.

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

Syntax

select: multiple; input[type=email]: multiple; input[type=file]: multiple. Boolean forms: multiple | multiple="" | multiple="multiple".

multiple ist ein boolesches Attribut: Ist es vorhanden, wird das Verhalten aktiviert; fehlt es, wird es deaktiviert. Gültige Schreibweisen sind multiple, multiple="" und multiple="multiple". multiple="false" ist ungültig und aktiviert das Verhalten trotzdem, weil das Attribut weiterhin vorhanden ist. Um es zu deaktivieren, muss das Attribut entfernt werden.

Bei select können damit null oder mehr Optionen ausgewählt werden; ohne das Attribut dient das Steuerelement zur Auswahl einer einzelnen Option. Es werden nicht automatisch alle Optionen ausgewählt. Das Attribut size legt fest, wie viele Optionen sichtbar sind, nicht wie viele ausgewählt werden dürfen.

Bei einem email-Eingabefeld ist eine durch Kommas, nicht durch Semikolons getrennte Adressliste möglich. Bei einem file-Eingabefeld können mehrere Dateien ausgewählt werden; ohne das Attribut kann die Liste der ausgewählten Dateien höchstens eine Datei enthalten. Für andere input-Typen ist es kein allgemeiner Mechanismus zur Eingabe mehrerer Werte.

Das Beispiel enthält zwei Optionen mit dem Attribut selected. Das Skript liest die Eigenschaft multiple und die Werte aus selectedOptions aus und zeigt anschließend das anfängliche Ergebnis an. Eine manuelle Auswahl ist nicht erforderlich.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>multiple example</title>
<label for="topics">Topics</label>
<select id="topics" multiple>
  <option value="html" selected>HTML</option>
  <option value="css" selected>CSS</option>
</select>
<pre id="result"></pre>
<script>
  const topics = document.getElementById('topics');
  const values = Array.from(topics.selectedOptions, option => option.value);
  document.getElementById('result').textContent =
    `${topics.multiple}\n${values.join(',')}`;
</script>
</html>

Ergebnis

true
html,css

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