Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

L’attribut HTML for

L’attribut `for` a une signification qui dépend de l’élément : il associe un `label` à un contrôle, indique les entrées d’un `output` ou relie un `template` à un marqueur nommé d’instruction de traitement. Ce n’est ni un attribut global ni une instruction qui effectue un calcul.

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

Syntaxe

<label for="control-id">…</label>
<output for="input-id-1 input-id-2">…</output>
<template for="marker-name">…</template>

L’attribut for décrit différentes relations selon l’élément. Ce n’est pas un attribut global. Pour label et output, il fait référence à des valeurs id, et non à des attributs name ou à des sélecteurs CSS.

Pour label, la valeur est un seul id qui identifie un élément étiquetable dans le même arbre. Le premier élément portant l’id correspondant dans l’ordre de l’arbre détermine l’association, mais uniquement s’il est étiquetable. Utilisez des identifiants uniques. En l’absence de for, le label est associé à son premier descendant étiquetable ; une valeur for invalide ne déclenche pas ce mécanisme de repli.

Pour output, la valeur est un ensemble non ordonné d’ID uniques séparés par des espaces. Chacun doit identifier un élément dans le même arbre dont la valeur ou le comportement a influencé le résultat. L’attribut ne calcule ni ne met à jour le résultat lui-même : dans l’exemple, un script s’en charge. Dans le DOM, label.htmlFor est une chaîne de caractères, tandis que output.htmlFor expose une DOMTokenList.

Pour template, la valeur identifie un marqueur nommé servant à insérer ou remplacer du contenu : elle doit correspondre à l’attribut name d’une instruction de traitement <?marker> ou <?start> dans le même arbre. Il ne s’agit pas d’une référence à un id. Ne confondez pas ce mécanisme avec l’étiquetage des formulaires ; vérifiez son fonctionnement dans les navigateurs ciblés avant de l’adopter.

Exemples

<!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>

Résultat

true
true true
5

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources