CKTIS / HTML
Das HTML-Attribut for
Das Attribut `for` hat je nach Element unterschiedliche Bedeutungen: Es verknüpft ein `label` mit einem Steuerelement, gibt Eingaben für ein `output` an oder verbindet ein `template` mit einer benannten Processing-Instruction-Markierung. Es ist weder ein globales Attribut noch eine Anweisung, eine Berechnung auszuführen.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<label for="control-id">…</label>
<output for="input-id-1 input-id-2">…</output>
<template for="marker-name">…</template>Das Attribut for beschreibt je nach Element unterschiedliche Beziehungen. Es ist kein globales Attribut. Bei label und output verweist es auf id-Werte, nicht auf name-Attribute oder CSS-Selektoren.
Bei label ist der Wert eine einzelne id, die ein beschriftbares Element im selben Baum identifiziert. Das erste Element mit der passenden id in der Baumreihenfolge bestimmt die Verknüpfung, aber nur, wenn es beschriftbar ist. Verwende eindeutige Kennungen. Ohne for wird das Label mit seinem ersten beschriftbaren Nachfahren verknüpft; ein ungültiges for löst diesen Rückfallmechanismus nicht aus.
Bei output ist der Wert eine ungeordnete Menge eindeutiger, durch Leerzeichen getrennter IDs. Jede muss ein Element im selben Baum identifizieren, dessen Wert oder Verhalten das Ergebnis beeinflusst hat. Das Attribut berechnet oder aktualisiert das Ergebnis nicht selbst – im Beispiel übernimmt das ein Skript. Im DOM ist label.htmlFor eine Zeichenfolge, während output.htmlFor eine DOMTokenList bereitstellt.
Bei template identifiziert der Wert eine benannte Markierung zum Einfügen oder Ersetzen von Inhalt: Er muss mit dem name-Attribut einer Processing Instruction <?marker> oder <?start> im selben Baum übereinstimmen. Dies ist kein Verweis auf eine id. Verwechsle diesen Mechanismus nicht mit der Beschriftung von Formularen; prüfe sein Verhalten in den Zielbrowsern, bevor du ihn verwendest.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>for attribute</title>
<label for="a">A</label>
<input id="a" type="number" value="2">
<label for="b">B</label>
<input id="b" type="number" value="3">
<output id="sum" for="a b"></output>
<script>
const a = document.getElementById('a');
const b = document.getElementById('b');
const sum = document.getElementById('sum');
function update() {
sum.value = String(a.valueAsNumber + b.valueAsNumber);
}
a.addEventListener('input', update);
b.addEventListener('input', update);
update();
console.log(document.querySelector('label').control === a);
console.log(sum.htmlFor.contains('a'), sum.htmlFor.contains('b'));
console.log(sum.value);
</script>
</html>Ergebnis
true true true 5
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.