CKTIS / HTML
Atrybut for w HTML
Atrybut `for` ma znaczenie zależne od elementu: łączy `label` z kontrolką, wskazuje źródła wyniku `output` albo wiąże `template` z nazwanym znacznikiem instrukcji przetwarzania. Nie jest atrybutem globalnym ani poleceniem wykonania obliczeń.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<label for="control-id">…</label>
<output for="input-id-1 input-id-2">…</output>
<template for="marker-name">…</template>Atrybut for opisuje różne powiązania zależnie od elementu. Nie jest atrybutem globalnym. W przypadku label i output odwołuje się do identyfikatorów id, a nie do atrybutów name ani selektorów CSS.
Dla label wartością jest jeden id elementu obsługującego etykiety, znajdującego się w tym samym drzewie. Powiązanie wyznacza pierwszy element o pasującym id w kolejności drzewa, ale tylko jeśli obsługuje on etykiety. Stosuj unikalne identyfikatory. Bez for etykieta wiąże się z pierwszym potomkiem obsługującym etykiety; niepoprawne for nie uruchamia tego mechanizmu zastępczego.
Dla output wartość jest nieuporządkowanym zbiorem unikalnych identyfikatorów rozdzielonych spacjami. Każdy musi wskazywać element w tym samym drzewie, którego wartość lub działanie wpłynęły na wynik. Atrybut sam nie oblicza ani nie aktualizuje wyniku — w przykładzie robi to skrypt. W DOM label.htmlFor jest ciągiem znaków, natomiast output.htmlFor udostępnia DOMTokenList.
Dla template wartość wskazuje nazwę znacznika używanego do wstawiania lub zastępowania treści: musi odpowiadać atrybutowi name instrukcji przetwarzania <?marker> albo <?start> w tym samym drzewie. Nie jest to odwołanie do id. Tego mechanizmu nie należy utożsamiać z etykietowaniem formularzy; przed zastosowaniem sprawdź jego działanie w docelowych przeglądarkach.
Przykłady
<!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>Wynik
true true true 5
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.