CKTIS / HTML
Het HTML-attribuut for
Het attribuut `for` heeft per element een andere betekenis: het koppelt een `label` aan een bedieningselement, geeft invoerwaarden voor een `output` aan of verbindt een `template` met een benoemde markering van een verwerkingsinstructie. Het is geen globaal attribuut en ook geen opdracht om een berekening uit te voeren.
Versie: 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>Het attribuut for beschrijft verschillende relaties, afhankelijk van het element. Het is geen globaal attribuut. Bij label en output verwijst het naar id-waarden, niet naar name-attributen of CSS-selectors.
Bij label is de waarde één id die een labelbaar element in dezelfde boom identificeert. Het eerste element met de overeenkomende id in de boomvolgorde bepaalt de koppeling, maar alleen als het labelbaar is. Gebruik unieke identificatiecodes. Zonder for wordt het label gekoppeld aan de eerste labelbare nakomeling; een ongeldige for activeert deze terugval niet.
Bij output is de waarde een ongeordende verzameling unieke, door spaties gescheiden ID’s. Elke ID moet een element in dezelfde boom identificeren waarvan de waarde of werking het resultaat heeft beïnvloed. Het attribuut berekent of actualiseert het resultaat niet zelf — in het voorbeeld doet een script dat. In de DOM is label.htmlFor een tekenreeks, terwijl output.htmlFor een DOMTokenList beschikbaar stelt.
Bij template identificeert de waarde een benoemde markering om inhoud in te voegen of te vervangen: deze moet overeenkomen met het name-attribuut van een verwerkingsinstructie <?marker> of <?start> in dezelfde boom. Dit is geen verwijzing naar een id. Verwar dit mechanisme niet met het labelen van formulieren; controleer hoe het werkt in de browsers waarop je je richt voordat je het gebruikt.
Voorbeelden
<!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>Resultaat
true true true 5
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.