CKTIS / HTML
L’attributo HTML for
L’attributo `for` ha significati diversi a seconda dell’elemento: associa un `label` a un controllo, indica gli input di un `output` oppure collega un `template` a un marcatore denominato di un’istruzione di elaborazione. Non è né un attributo globale né un’istruzione che esegue un calcolo.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<label for="control-id">…</label>
<output for="input-id-1 input-id-2">…</output>
<template for="marker-name">…</template>L’attributo for descrive relazioni diverse a seconda dell’elemento. Non è un attributo globale. Con label e output fa riferimento a valori id, non ad attributi name o a selettori CSS.
Per label, il valore è un singolo id che identifica un elemento etichettabile nello stesso albero. L’associazione è determinata dal primo elemento con l’id corrispondente nell’ordine dell’albero, ma solo se è etichettabile. Usa identificatori univoci. Se for è assente, l’etichetta si associa al primo discendente etichettabile; un valore for non valido non attiva questo ripiego.
Per output, il valore è un insieme non ordinato di ID univoci separati da spazi. Ciascuno deve identificare un elemento nello stesso albero il cui valore o comportamento abbia influenzato il risultato. L’attributo non calcola né aggiorna il risultato da solo: nell’esempio se ne occupa uno script. Nel DOM, label.htmlFor è una stringa, mentre output.htmlFor espone un DOMTokenList.
Per template, il valore identifica un marcatore denominato per inserire o sostituire contenuti: deve corrispondere all’attributo name di un’istruzione di elaborazione <?marker> o <?start> nello stesso albero. Non è un riferimento a un id. Non confondere questo meccanismo con l’etichettatura dei moduli; prima di adottarlo, verifica come funziona nei browser di destinazione.
Esempi
<!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>Risultato
true true true 5
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.