Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła