База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

HTML атрибутът for

Атрибутът `for` има различно значение според елемента: свързва `label` с контрола, посочва входни елементи за `output` или свързва `template` с именуван маркер на инструкция за обработка. Той не е глобален атрибут и не е инструкция за извършване на изчисление.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

Атрибутът for описва различни връзки в зависимост от елемента. Той не е глобален атрибут. При label и output се отнася до стойности id, а не до атрибути name или CSS селектори.

При label стойността е един id, който идентифицира елемент, подлежащ на етикетиране, в същото дърво. Връзката се определя от първия елемент със съвпадащ id в реда на дървото, но само ако той подлежи на етикетиране. Използвайте уникални идентификатори. Без for етикетът се свързва с първия си потомък, подлежащ на етикетиране; невалиден for не задейства този резервен механизъм.

При output стойността е неподредено множество от уникални ID, разделени с интервали. Всеки трябва да идентифицира елемент в същото дърво, чиято стойност или поведение е повлияло на резултата. Самият атрибут не изчислява и не актуализира резултата — в примера това прави скрипт. В DOM label.htmlFor е низ, докато output.htmlFor предоставя DOMTokenList.

При template стойността идентифицира именуван маркер за вмъкване или замяна на съдържание: тя трябва да съвпада с атрибута name на инструкция за обработка <?marker> или <?start> в същото дърво. Това не е препратка към id. Не бъркайте този механизъм с етикетирането на формуляри; преди да го използвате, проверете поведението му в целевите браузъри.

Примери

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

Резултат

true
true true
5

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници