Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

O atributo for de HTML

O atributo `for` tem significados diferentes consoante o elemento: associa um `label` a um controlo, identifica entradas de um `output` ou liga um `template` a um marcador com nome de uma instrução de processamento. Não é um atributo global nem uma instrução para efetuar um cálculo.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

O atributo for descreve relações diferentes consoante o elemento. Não é um atributo global. Em label e output, refere-se a valores id, não a atributos name nem a seletores CSS.

Em label, o valor é um único id que identifica um elemento etiquetável na mesma árvore. A associação é determinada pelo primeiro elemento com o id correspondente na ordem da árvore, mas apenas se for etiquetável. Utilize identificadores únicos. Sem for, o rótulo associa-se ao seu primeiro descendente etiquetável; um valor for inválido não ativa este mecanismo alternativo.

Em output, o valor é um conjunto não ordenado de ID únicos separados por espaços. Cada um tem de identificar um elemento na mesma árvore cujo valor ou comportamento tenha influenciado o resultado. O atributo não calcula nem atualiza o resultado por si só — no exemplo, essa tarefa cabe a um script. No DOM, label.htmlFor é uma cadeia de caracteres, enquanto output.htmlFor expõe um DOMTokenList.

Em template, o valor identifica um marcador com nome para inserir ou substituir conteúdo: tem de corresponder ao atributo name de uma instrução de processamento <?marker> ou <?start> na mesma árvore. Não é uma referência a um id. Não confunda este mecanismo com a etiquetagem de formulários; verifique o seu funcionamento nos navegadores de destino antes de o adotar.

Exemplos

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

Resultado

true
true true
5

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes