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.