<label>

HTML элемент <label> представляет собой подпись к элементу пользовательского интерфейса.

Категории контента Общий поток, текстовый контент, интерактивный контент, элемент формы, ощутимый контент.
Разрешённый контент Текстовый контент, но без вложенных элементов label. Недопустимы другие оборачиваемые в label элементы помимо целевого.
Пропуск тегов Нет, открывающий и закрывающий теги обязательны.
Разрешённые предки Любой элемент, разрешающий текстовый контент.
Разрешённые ARIA роли Отсутствуют
DOM interface HTMLLabelElement (en-US)
Тип Строчный

Атрибуты

Элемент поддерживает глобальные атрибуты .

for

ID labelable-элемента, который находится в том же документе, что и элемент label. Первый такой элемент в документе, ID которого совпадает со значением атрибута for, становится labeled-контролом для данного label.

Элемент label может иметь как атрибут for, так и отдельный элемент управления, если атрибут for указывает на содержащийся элемент управления.
form HTML5 Этот API вышел из употребления и его работа больше не гарантируется.
Элемент формы, с которым связан label (его владелец формы). Если указано, значением атрибута является идентификатор элемента <form> в том же документе. Это позволяет размещать элементы label в любом месте документа, а не только как потомки их элементов формы..
Этот атрибут содержимого был удалён из спецификации HTML 28 апреля 2016 г. Однако сценарии по-прежнему имеют доступ только для чтения HTMLLabelElement.form (en-US); он возвращает форму, членом которой является связанный элемент управления label, или значение NULL, если label не связана с элементом управления или элемент управления не является частью формы.

Примечания по использованию

  • <label> можно связать с элементом управления, поместив элемент управления внутри элемента <label> или используя атрибут for. Такой элемент управления называется помеченным элементом управления надписью. Один вход может быть связан с несколькими метками.
  • Метки сами по себе не связаны с формами. Они только косвенно связаны с формами через элементы управления, с которыми они связаны.

Examples

Simple label example

<label>Click me <input type="text"></label>

Using the "for" attribute

<label for="username">Click me</label>
<input type="text" id="username">

Specifications

Specification Status Comment
HTML Living Standard
Определение '<label>' в этой спецификации.
Живой стандарт
HTML5
Определение '<label>' в этой спецификации.
Рекомендация
HTML 4.01 Specification
Определение '<label>' в этой спецификации.
Рекомендация Initial definition

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Да) (Да) (Да)[1] (Да) (Да) (Да)
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Да) (Да) (Да)[1] (Да) (Да) (Да)

[1] Starting with Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5), a bubbling click event triggers at most one <label>, and the synthetic click event cannot trigger additional <label>s. In Gecko, a click event will still bubble up past a <label>, while in WebKit or Internet Explorer the click event will stop at the <label>. The behavior prior to Gecko 8.0 (triggering multiple <label>s) caused Firefox to stop responding (see баг 646157).

[2] The HTML specification was updated in April 2016 to deprecate the form attribute. It's still available from script, but its definition has changed: it now returns the associated control's form, or null if there is no associated control (that is, if HTMLLabelElement.control (en-US) is null). See HTMLLabelElement.form (en-US).

This change is implemented in Firefox 49.

See also