WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

HTML-Attribut name — elementspezifische Bedeutung

Das Attribut `name` vergibt einen elementspezifischen Namen: einen Schlüssel für Formulardaten, einen Navigationszielnamen, einen Namen für eine Imagemap, eine `details`-Gruppe, einen Slot oder Metadaten. Es ist kein globales Attribut und kein Ersatz für `id`.

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

Syntax

name="value"

name ist kein globales Attribut: Bedeutung und Einschränkungen hängen vom Element ab. Es ersetzt weder id noch eine für Nutzer sichtbare barrierefreie Beschriftung. Insbesondere verweist label[for] auf die id eines Steuerelements, nicht auf dessen name.

Bei Formularsteuerelementen liefert name den Namen, der beim Absenden und in der Sammlung form.elements verwendet wird. Ein angegebener Wert darf weder leer noch isindex sein. Wiederholte Namen können mehrere Einträge ergeben; ein gemeinsamer Name gruppiert außerdem Radiobuttons, die zum selben Formular und Baum gehören. Ein gewöhnliches Textfeld ohne Namen erzeugt keinen Eintrag. Ein Name allein garantiert keine Übermittlung: Deaktivierte Steuerelemente und nicht ausgewählte Checkboxen werden beispielsweise ausgelassen. Vermeide Namen von integrierten Formulareigenschaften wie submit: Sie können diese Eigenschaften im DOM überschreiben.

Bei form ermöglicht der Name den Zugriff über document.forms; er muss nicht leer und innerhalb dieser Sammlung eindeutig sein. Bei iframe und, sofern zutreffend, object benennt er das interne Navigationsziel bei dessen Erstellung, etwa für die Verwendung mit target. Er muss ein gültiger navigierbarer Zielname sein. Bei map ist das Attribut erforderlich: Der von usemap referenzierte Name muss nicht leer sein, darf keine ASCII-Leerzeichen enthalten und muss in seinem Baum eindeutig sein; eine angegebene id muss mit ihm übereinstimmen.

Bei details erzeugt ein gemeinsamer, nicht leerer Name eine Gruppe im selben Baum: Wird ein Element geöffnet, werden die anderen geschlossen. Verschachtele keine Mitglieder derselben Gruppe und markiere nicht mehrere als geöffnet. Überlege, ob Nutzer mehrere Abschnitte gleichzeitig sehen müssen. Bei slot bezeichnet der Name einen Slot in einem Shadow Tree und stimmt mit dem slot-Attribut eines Kindelements des Hosts überein; er darf eine leere Zeichenfolge sein.

Bei meta bezeichnet der Name die Art der Metadaten, etwa description, während content den Wert enthält. Metadatennamen werden ohne Beachtung der ASCII-Groß-/Kleinschreibung verglichen. Kombiniere name nicht mit http-equiv, charset oder itemprop auf demselben meta.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>name example</title>
<form id="profile" name="profileForm">
  <label>City <input id="city" name="city" value="Warsaw"></label>
  <input name="tag" value="html" type="hidden">
  <input name="tag" value="forms" type="hidden">
  <label>Ignored <input value="not submitted"></label>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById("profile");
  const pairs = [...new FormData(form).entries()];
  document.getElementById("result").textContent = JSON.stringify(pairs);
</script>
</html>

Ergebnis

[["city","Warsaw"],["tag","html"],["tag","forms"]]

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