Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti