Обратите внимание, что

1. данный документ является переводом документа «3 Semantics, structure, and APIs of HTML documents — HTML5» и на данный момент находится на стадии перевода;
2. данный документ может содержать неточности, опечатки и ошибки перевода;
3. официальным документом по данной тематике является оригинальный документ на английском языке, расположенный на сайте W3C.

3 Семантика, структура и API HTML-документов

* * *

3.2 Элементы

* * *

3.2.5 Глобальные атрибуты

* * *

3.2.5.1 Атрибут id

Атрибут id задаёт элементу уникальный идентификатор (ID). [DOM]

Значение данного атрибута должно быть уникальным среди всех ID в домашнем поддереве элементов, а также должно содержать не менее одного символа. При этом значение не должно содержать пробельных символов.

Отсутствуют ограничения на то, какие значения может принимать ID, в частности, идентификаторы могут состоять только из цифр, начинаться с цифры, с символа подчеркивания, состоять только из знаков препинания и т.д.

уникальный идентификатор элемента может быть использован для различных целей, в первую очередь для установки якоря, в конкретной части документа используя идентификаторы фрагментов, потом как способ указания уникального имени элемента для работы с ним из скриптов, а так же для того чтобы установить CSS стиль для конкретного элемента.

3.2.5.2 Атрибут title

Атрибут title представляет справочную информацию для элемента, например, в виде всплывающей подсказки. При указывании атрибута в теге ссылки, он может выполнять роль названия или описания целевого ресурса; в изображении может выполнять роль альтернативы изображению или описание изображения; в теге абзаца может выполнять роль сноски или комментария к тексту; в цитате может выполнять роль дополнительной информации об источнике; в интерактивном содержимом может выполнять роль отметки или инструкции к использованию элемента; и так далее. В качестве значения данного атрибута может выступать любой текст.

Полагаться на атрибут title в настоящее время не рекомендуется, поскольку многие агенты пользователей не предоставляют атрибут в доступной форме в соответствии с требованиями настоящей спецификации (например, требуется указывающее устройство, такое как мышь, чтобы вызвать всплывающую подсказку, что исключает не только устройства, использующие только клавиатуру, но и устройства, использующие только сенсорное управление, такие как любой современный телефон или планшет).

Если этот атрибут опущен из элемента, то подразумевается, что атрибут title ближайшего предка являющегося HTML элементом с title атрибутом является также актуальным по отношению к данному элементу. Установка данного атрибута переопределяет это правило, прямо указывая, что справочная информация от любых родительских элементов больше не имеет отношения к этому элементу. Установка пустой строки в качестве значения данного атрибута означает, что у элемента отсутствует всплывающая подсказка.

Если значение title атрибута содержит «LF» (U+000A) символы, то содержание разделяется на несколько строк. Каждый «LF» (U +000A) символ во всплывающей подсказке представляет символ перевода строки.

<p>My logs show that there was some interest in <abbr title="Hypertext
	Transport Protocol">HTTP</abbr> today.</p>

Некоторые элементы, такие как link, abbr, и input, определяют дополнительную семантику для атрибута title за пределами семантики, описанной выше.

3.2.5.3 Атрибуты lang и xml:lang

Атрибут lang (без пространства имён) указывает основной язык содержимого элемента и любого из атрибутов элемента, содержащих текст. Его значение должно быть допустимым BCP 47 языковым тегом, или пустой строкой. Установка пустой строки в качестве атрибута указывает, что основной язык неизвестен. [BCP47]

XML атрибут lang в XML пространстве имён определён в XML. [XML]

Если данные атрибуты не указаны в элементе, то язык этого элемента совпадает с языком его родительского элемента, если таковой имеется.

Атрибут lang вне пространства имён может быть использован в любом HTML элементе.

Атрибут lang в XML пространстве имён может быть использован в HTML элементах в XML документах, а также в элементах других пространств имён, если позволяют это соответствующие технические характеристики (в частности, в MathML и SVG допускается использование lang атрибутов в XML пространстве имён указаных в их элементах). Если и атрибут lang не принадлежащий пространству имён и атрибут lang принадлежащий XML пространству имён указывается в одном элементе, то они должны иметь одинаковое значение без учёта ASCII регистра символов.

Авторы не должны использовать XML атрибут lang принадлежащий the XML пространству имён в HTML элементах HTML документов. Для облегчения перехода от XHTML, авторы могут указать атрибут не принадлежащий пространству имён без префикса и с буквальным локальным именем "xml:lang" в HTML элементах HTML документов, но такие атрибуты должны быть указаны только в случае, если для элемента уже указан атрибут lang не принадлежащий пространству имён, при условии, что оба этих атрибута имеют одинаковое значение без учёта ASCII регистра символов.

Атрибут вне пространства имён без префикса и с буквальным локальным именем "xml:lang" не влияет на обработку языка.

3.2.5.4 Атрибут translate

Атрибут translate является перечисляемым атрибутом, который используется для определения необходимости перевода значений атрибутов элементов и значений их дочерних Текстовых узлов в условиях, когда страница локализована.

Ключевыми словами атрибута являются: пустая строка, yes, и no. Пустая строка и ключевое слово yes указывают на состояние – yes. Ключевое слово no указывает на состояние – no. Кроме того, существует еще и третье состояние, состояние наследования, которое является отсутствующим значением, выполняемым по умолчанию (и недопустимое значение по умолчанию).

Каждый элемент (даже не HTML-элементы) имеет режим перевода, который может находиться в состоянии поддержки перевода или в состоянии без поддержки перевода. Если атрибут translate HTML-элемента находится в состоянии yes, то режим перевода элемента находится в состоянии поддержки перевода; в противном случае, если translate атрибут элемента находится в состоянии no, то режим перевода элемента находится в состоянии без поддержки перевода. В противном случае, либо translate атрибут элемента наследует состояние, либо элемент не является HTML элементом и таким образом не имеет translate атрибут; в любом случае, режим перевода элемента находится в том же состоянии, что и его родительский элемент, если таковой имеется, или в состоянии поддержки перевода, если элемент является корневым элементом.

Когда элемент находится в состоянии поддержки перевода, то элементы с атрибутами перевода и значения их дочерних Текстовых узлов должны быть переведены в условиях, когда страница локализована. Атрибуты элемента, которые не указаны в качестве атрибутов перевода не должны переводиться.

Когда элемент находится в состоянии без поддержки перевода, то значения атрибутов элементов (в том числе значения атрибутов перевода) и значения их дочерних Текстовых узлов должны быть оставлены, как есть в условиях, когда страница локализована, например, в виду того, что элемент содержит имя человека или название компьютерной программы.

Следующие атрибуты являются переводимыми атрибутами:

• abbr в th элементах
• alt в area, img и input элементах
• content в meta элементах, если атрибут name указывает имя метаданных, значение которого, как известно, переводится
• download в a и area элементах
• label в optgroup, option, и track элементах
• lang в HTML элементах; должно быть «переведено» на соответствующий язык, используемый в переводе
• placeholder в input и textarea элементах
• srcdoc в iframe элементах; должно быть проанализировано и обрабатываться рекурсивно
• style в HTML элементах; должно быть проанализировано и обрабатываться рекурсивно (например, для значений "содержащихся" свойств)
• title во всех HTML элементах
• value в input элементах с атрибутом type в состоянии Button или в состоянии Reset Button

<!DOCTYPE HTML>
<html> <!-- по умолчанию в корневом элементе translate=yes -->
 <head>
  <title>Игра Пчёлы</title> <!-- подразумевается, что translate=yes наследуется от родительских элементов -->
 </head>
 <body>
  <p>Игра Пчелы представляет собой текстовую приключенческую игру на английском языке.</p>
  <p>При запуске игры, первое, что вы должны сделать, это набрать
  <kbd translate=no>поесть мёд</kbd>. Игра должна ответить:</p>
  <pre><samp translate=no>Ням ням! Это был очень хороший мёд!</samp></pre>
 </body>
</html>

3.2.5.6 Атрибут dir

Атрибут dir указывает направление текста элемента. Атрибут представляет собой перечисляемый атрибут со следующими ключевыми словами и значениями:

Ключевое слово ltr, которое является значением ltr

Указывает, что содержимое элемента имеет явно обособленное направление текста слева направо.

Ключевое слово rtl, которое является значением rtl

Указывает, что содержимое элемента имеет явно обособленное направление текста справа налево.

Ключевое слово auto, которое является значением auto

Указывает, что содержимое элемента имеет явно обособленное направление текста, но это направление должно быть определено программно, используя содержимое элемента (как описано ниже).

Эвристически используемое данное состояние очень примитивно (оно просто смотрит на первый символ с сильной направленностью, аналогично тому, как в пункте определения уровня алгоритма двунаправленного вывода). Авторам настоятельно рекомендуется использовать это значение в качестве последнего средства, в случае, когда направление текста действительно неизвестно, и когда эвристика не может быть применена на стороне сервера. [BIDI]

Для textarea и pre элементов, эвристика применяется на уровне абзацев.

Этот атрибут не имеет недопустимого значения по умолчанию и не отсутствующего значения по умолчанию.

Направленность элемента (любого элемента, а не только элемента HTML) имеет одно из двух состояний - 'ltr' или 'rtl', и определяется в соответствии с первым соответствующим набором действий из следующего списка:

Если атрибут dir элемента имеет значение ltr

Если элемент является корневым элементом и атрибут dir не имеет определенного состояния (т.е. он отсутствует или имеет недопустимое значение)

Если элемент является input элементом, чей атрибут type находится в состоянии Номера телефона, и атрибут dir не имеет определенного состояния (т.е. он отсутствует или имеет недопустимое значение)

Направленность элемента принимает значение 'ltr'.

Если атрибут dir элемента имеет значение rtl

Направленность элемента принимает значение 'rtl'.

Если элемент является input элементом, чей атрибут type имеет значение Text, Search, Telephone, URL или E-mail и атрибут dir находиться в состоянии auto

Если элемент является textarea элементом и атрибут dir находиться в состоянии auto

Если значение элемента содержит символ с двунаправленным характером типа AL или R, и нигде до этого в значение элемента нет символа двунаправленного характера типа L, то направленность элемента определяется как 'rtl'. [BIDI]

В противном случае, если значение элемента - не пустая строка, или если элемент является корневым элементом, направленность элемента принимает значение 'ltr'.

В противном случае, направленность элемента наследуется от направленности родительского элемента.

Если атрибут dir элемента имеет значение auto

Если элемент является bdi элементом и атрибут dir не имеет определенного состояния (т.е. он отсутствует или имеет недопустимое значение)

Находтся первый символ структуре дерева, который соответствует следующим критериям:

• Символ из Текстового узла, который является потомком элемента, чья направленность в настоящее время определяется.

• Символ, указывающий двунаправленный характер типа L, AL, или R. [BIDI]

• Символ, не находящийся в Текстовом узле, имеющий родительский элемент, который является потомком элемента, чья направленность определена, либо:

  • Элемент bdi.
  • Элемент script.
  • Элемент style.
  • Элемент textarea.
  • Элемент с атрибутом dir в определённом состоянии.

Если такой символ найден и имеет двунаправленный характер типа AL или R, направленность элемента принимает значение 'rtl'.

Если такой символ найден и имеет двунаправленный характер типа L, направленность элемента принимает значение 'ltr'.

В противном случае, если элемент является пустым и не является корневым элементом, направленность элемента такая же, как и направленность родительского элемента.

В противном случае, направленность элемента принимает значение 'ltr'.

Если элемент имеет родительский элемент и атрибут dir не имеет определенного состояния (т.е. он отсутствует или имеет недопустимое значение)

Направленность элемента наследуется от направленности родительского элемента.

Поскольку атрибут dir определяется только для HTML-элементов, он не может присутствовать в элементах из других пространств имён. Таким образом, элементы из других пространств имён всегда просто наследуют их направленность от родительского элемента, или, если они не имеют единственного значения по умолчанию - 'ltr'.

Атрибут направленности HTML-элемента, который используется, когда значение этого атрибута будет принято на исполнение в некотором образе, определяется, как и в первом соответствующем наборе действий из следующего списка:

Если атрибут направленности является работоспособным атрибутом и dir атрибут элемента находиться в состоянии auto

Нахождится первый символ (в логическом порядке) атрибута, который имеет двунаправленный характер типа L, AL, или R. [BIDI]

Если такой символ найден и имеет двунаправленный характер типа AL или R, направленность атрибут принимает значение 'rtl'.

В противном случае, направленность атрибута принимает значение 'ltr'.

В противном случае

Атрибут направленности имеет значение соответствующее направленности элемента.

Следующие атрибуты являются поддерживаемыми атрибутами направленности:

• abbr в th элементах
• alt в area, img и input элементах
• content в meta элементах, если атрибут name указывает имя метаданных, значение которого в первую очередь предназначено для человеческого понимания, а не для чтения машиной
• label в optgroup, option и track элементах
• placeholder в input и textarea элементах
• title во всех HTML-элементах

document . dir [ = value ]

Возвращает значение dir атрибутов html элемента, если таковые имеются.

Может быть установлено, "ltr", "rtl", либо "auto" для изменения значения dir атрибутов html элемента

Если html элемент отсутствует, то возвращается пустая строка, и игнорируются новые значения.

Разработчикам настоятельно рекомендуется для указания направления текста использовать атрибут dir, а не прибегать к помощи CSS, потому что в этом случае их документы будут продолжать отображаться правильно, даже в отсутствии CSS (например, в интерпретации поисковых систем).

<p dir=auto class="u1"><b><bdi>Студент</bdi>:</b> Как пишется "Как тебя зовут?" по-арабски?</p>
<p dir=auto class="u2"><b><bdi>Учитель</bdi>:</b> ما اسمك؟</p>
<p dir=auto class="u1"><b><bdi>Студент</bdi>:</b> Спасибо.</p>
<p dir=auto class="u2"><b><bdi>Учитель</bdi>:</b> Данное слово пишется как "شكرًا".</p>
<p dir=auto class="u2"><b><bdi>Учитель</bdi>:</b> А вы знаете, как пишется "Пожалуйста"?</p>
<p dir=auto class="u1"><b><bdi>Студент</bdi>:</b> "من فضلك", правильно?</p>

3.2.5.7 Атрибут class

Каждый HTML элемент может иметь атрибут class.

Атрибут, если он указан, должен иметь значение, которое представляет собой набор разделённых пробелами лексем, представляющих различные классы, которым принадлежит элемент.

Присваиваемые элементу классы влияют на класс соответствующих CSS селекторов, метод getElementsByClassName() в DOM, и другие подобные функции.

Нет никаких дополнительных ограничений на использование авторами маркеров классов в атрибуте class, но при этом авторам рекомендуется использовать значения, описывающие характер содержимого, а не значения, которые описывают желаемое представление контента.

3.2.5.8 Атрибут style

Все HTML элементы могут иметь атрибут style. Этот атрибут является атрибутом CSS стилей, определённых спецификацией CSS Синтаксиса Атрибута Стиля. [CSSATTR]

Документы, которые используют атрибуты style в своих элементах, должны быть понятными и пригодными, даже в случае удаления этих атрибутов.

В частности, с помощью атрибута style можно скрывать и показывать содержимое элемента, а так же передавать смысл который из-за несоответствия мог бы и не быть включён в документ. (Для скрытия и отображения содержимого элемента используйте атрибут hidden.)

element . style

Возвращает CSSStyleDeclaration объект для элементов с атрибутом style.

<p>Мой тренировочный костюм <span style="color: green; background:
transparent">зелёного цвета</span>, а мои глаза <span style="color: blue;
background: transparent">синего цвета</span>.</p>

3.2.5.9 Внедрение скрытых пользовательских данных с помощью атрибутов data-*

Атрибут пользовательских данных является атрибутом вне пространства имён, имя которого начинается со строки "data-", сам он имеет, по крайней мере, один символ дефиса, является XML-совместимым, и не содержит прописных ASCII букв.

Все имена атрибутов HTML-элементов в HTML-документах получают автоматически ASCII-нижний регистр, поэтому ограничения на прописные ASCII буквы не влияет на подобные документы.

Атрибуты пользовательских данных предназначены для хранения пользовательских данных частной страницы или приложения, для которых больше нет соответствующих атрибутов или элементов.

Эти атрибуты не предназначены для использования программным обеспечением, которое не зависит от сайта, на котором используются данные атрибуты.

<ol>
 <li data-length="2m11s">За морем</li>
 ...
</ol>

Каждый HTML-элемент может иметь любое количество атрибутов пользовательских данных, указывающих любое значение.

element . dataset

Возвращает объект DOMStringMap для элементов с атрибутами data-*.

Комбинированные имена преобразуются с изменением регистра. Например, data-foo-bar="" становится element.dataset.fooBar.

<div class="spaceship" data-ship-id="92432"
     data-weapons="laser 2" data-shields="50%"

     data-x="30" data-y="10" data-z="90">
 <button class="fire"
         onclick="spaceships[this.parentNode.dataset.shipId].fire()">
  Огонь
 </button>
</div>

Авторы должны настолько тщательно разработать подобные расширения, что бы в случае, когда атрибуты игнорируются и любые указываемые CSS перестают работать, страница всё еще была бы пригодна к использованию.

JavaScript библиотеки могут использовать атрибуты пользовательских данных, так как они считаются частью страницы, на которой они используются. Авторам библиотек, которые используются многими другими авторами, предлагается включить своё название в имена атрибутов, чтобы снизить риск совпадений. Там где это имеет смысл, в библиотеке также рекомендуется сделать название, используемое в именах атрибутов настраиваемым, так чтобы библиотеки, авторы которых неосознанно выбрали то же название, могли бы использовать эти имена на одной странице, а так же, что бы несколько версий конкретной библиотеки, могли бы быть использованы на той же странице, даже если эти версии являются не совместимыми.