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

Глобальные атрибуты — это атрибуты, общие для всех элементов HTML; их можно использовать со всеми элементами, хотя на некоторые элементы они могут не влиять.

Глобальные атрибуты можно указывать для всех элементов HTML, даже для тех, которые не описаны в стандарте. Это означает, что даже нестандартные элементы должны поддерживать эти атрибуты, хотя использование таких элементов лишает документ соответствия HTML5. Например, браузеры, соответствующие HTML5, скрывают содержимое, помеченное как <foo hidden>…</foo>, хотя <foo> не является допустимым элементом HTML.

Помимо основных глобальных атрибутов HTML, существуют также следующие глобальные атрибуты:

xml:lang и xml:base — они унаследованы из спецификаций XHTML и считаются устаревшими, но сохранены для обеспечения совместимости.
Атрибут ARIA role и многочисленные состояния и свойства aria-*, используемые для обеспечения доступности.
Перечисленные ниже атрибуты обработчиков событий.

Список глобальных атрибутов

accesskey

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

anchor

Связывает позиционируемый элемент с элементом-якорем. Значение атрибута — это значение id элемента, к которому нужно привязать позиционируемый элемент. Затем элемент можно позиционировать с помощью позиционирования относительно якоря в CSS.

autocapitalize

Управляет автоматическим преобразованием введённого текста в верхний регистр и, если оно включено, определяет способ такого преобразования.

autocorrect

Управляет автоматическим исправлением орфографических ошибок во вводимом тексте. Этот атрибут можно применять к элементам с редактируемым текстом, кроме элементов <input> с атрибутом: type="password", type="email" или type="url".

autofocus

Указывает, что элемент должен получить фокус при загрузке страницы или сразу после отображения <dialog>, частью которого он является. Этот атрибут является логическим и изначально имеет значение false.

class

Список классов элемента, разделённых пробелами. С помощью классов CSS и JavaScript могут выбирать и находить определённые элементы через селекторы классов или такие функции, как метод Document.getElementsByClassName().

contenteditable

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

true или пустая строка, указывающие, что элемент можно редактировать;
false, указывающее, что элемент нельзя редактировать.
plaintext-only, указывающее, что исходный текст элемента можно редактировать, но форматирование расширенного текста отключено.

data-*

Образует класс атрибутов, называемых пользовательскими атрибутами данных. Они позволяют обмениваться собственными данными между HTML и его представлением в DOM, которые могут использоваться скриптами. Все такие пользовательские данные доступны через интерфейс HTMLElement элемента, для которого задан атрибут. Свойство HTMLElement.dataset предоставляет доступ к ним.

dir

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

ltr, то есть слева направо; используется для языков, которые пишутся слева направо (например, английского);
rtl, то есть справа налево; используется для языков, которые пишутся справа налево (например, арабского);
auto позволяет браузеру определить направление самостоятельно. При разборе символов внутри элемента применяется простой алгоритм: он ищет символ с выраженным направлением текста, а затем применяет это направление ко всему элементу.

draggable

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

true, указывающее, что элемент можно перетаскивать;
false, указывающее, что элемент нельзя перетаскивать.

enterkeyhint

Подсказывает, какую подпись действия (или значок) отображать для клавиши ввода на виртуальных клавиатурах.

exportparts

Используется для транзитивного экспорта частей теневого дерева из вложенного теневого дерева в содержащий его обычный DOM.

hidden

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

id

Задаёт уникальный идентификатор (ID), который должен быть уникальным во всём документе. Он предназначен для идентификации элемента при создании ссылок (с использованием идентификатора фрагмента), написании скриптов или задании стилей (с помощью CSS).

inert

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

inputmode

Подсказывает браузерам, какую конфигурацию виртуальной клавиатуры использовать при редактировании элемента или его содержимого. В основном применяется к элементам <input>, но может использоваться с любым элементом в режиме contenteditable.

is

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

Примечание: Атрибуты item* относятся к функции микроразметки HTML WHATWG.

itemid

Уникальный глобальный идентификатор элемента.

itemprop

Используется для добавления свойств элементу. Для любого элемента HTML можно указать атрибут itemprop, где itemprop состоит из пары «имя — значение».

itemref

Свойства, которые не являются потомками элемента с атрибутом itemscope, можно связать с элементом с помощью itemref. Он содержит список идентификаторов элементов (не itemid) с дополнительными свойствами в других частях документа.

itemscope

itemscope обычно используется вместе с itemtype, чтобы указать, что HTML-код в блоке описывает определённый элемент. itemscope создаёт элемент и определяет область действия связанных с ним itemtype. itemtype — это действительный URL словаря (например, schema.org), описывающего элемент и контекст его свойств.

itemtype

Задаёт URL словаря, который будет использоваться для определения itemprop (свойств элемента) в структуре данных. Атрибут itemscope задаёт область структуры данных, в которой будет действовать словарь, указанный в itemtype.

lang

Помогает определить язык элемента: язык, на котором написаны нередактируемые элементы, или язык, на котором пользователь должен писать в редактируемых элементах. Атрибут должен содержать действительный языковой тег BCP 47. Атрибут xml:lang имеет более высокий приоритет.

nonce

Криптографический одноразовый номер (nonce), который может использоваться политикой безопасности содержимого, чтобы определить, разрешено ли выполнить конкретный запрос.

part

Список имён частей элемента, разделённых пробелами. Имена частей позволяют CSS выбирать и стилизовать определённые элементы в теневом дереве с помощью псевдоэлемента ::part.

popover

Используется для обозначения элемента как всплывающего элемента (см. API всплывающих элементов). Всплывающие элементы скрыты с помощью display: none до тех пор, пока не будут открыты вызывающим элементом или элементом управления (то есть <button> или <input type="button"> с атрибутом popovertarget) либо вызовом HTMLElement.showPopover().

role

Роли определяют семантическое значение содержимого, позволяя программам чтения с экрана и другим инструментам представлять объект и взаимодействовать с ним способом, соответствующим ожиданиям пользователей. roles добавляются к элементам HTML с помощью role="role_type", где role_type — это имя роли из спецификации ARIA.

slot

Назначает элементу слот в теневом дереве теневого DOM: элемент с атрибутом slot назначается слоту, созданному элементом <slot>, значение атрибута name которого совпадает со значением этого атрибута slot.

spellcheck

Перечисляемый атрибут, определяющий, можно ли проверять элемент на орфографические ошибки. Он может принимать следующие значения:

пустая строка или true, указывающие, что орфографические ошибки в элементе следует проверять, если это возможно;
false, указывающее, что орфографические ошибки в элементе проверять не следует.

style

Содержит объявления стилей CSS, применяемые к элементу. Рекомендуется задавать стили в отдельных файлах. Этот атрибут и элемент <style> предназначены главным образом для быстрого задания стилей, например в целях тестирования.

tabindex

Целочисленный атрибут, указывающий, может ли элемент получать фокус ввода (фокусируемый ли он), должен ли он участвовать в последовательной навигации с клавиатуры и, если должен, то на какой позиции. Он может принимать несколько значений:

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

title

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

translate

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

пустая строка или yes, указывающие, что элемент будет переведён;
no, указывающее, что элемент переводить не следует.

virtualkeyboardpolicy

Перечисляемый атрибут, управляющий поведением экранной виртуальной клавиатуры на таких устройствах, как планшеты, мобильные телефоны и другие устройства, на которых может отсутствовать аппаратная клавиатура. Применяется к элементам с редактируемым содержимым (например, к элементам <input> или <textarea>, а также к элементам с установленным атрибутом contenteditable).

auto или пустая строка, автоматически отображающие виртуальную клавиатуру при получении элементом фокуса или касании;
manual, отделяющее фокусировку и касание элемента от состояния виртуальной клавиатуры.

writingsuggestions

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

false, отключающее подсказки при вводе текста в браузере;
true или пустая строка, включающие подсказки при вводе текста.

Список глобальных атрибутов обработчиков событий

Использовать атрибуты обработчиков событий HTML не рекомендуется; описание их работы см. в справочнике по атрибутам HTML.

Хотя перечисленные ниже атрибуты применимы ко всем элементам, они не всегда полезны. Например, атрибут HTML onvolumechange принимается всеми элементами и добавляет обработчик события для volumechange, но событие volumechange, инициируемое браузером, получают только мультимедийные элементы. Для остальных элементов вызвать его можно только вручную с помощью EventTarget.dispatchEvent(). Некоторые атрибуты можно указывать для элемента <body>, но в таком случае они будут отслеживать события на window.

Спецификации

Спецификация
HTML> # the-hidden-attribute>
HTML> # classes>
HTML> # attr-spellcheck>
HTML> # attr-autocapitalize>
HTML> # the-popover-attribute>
HTML> # attr-is>
HTML> # attr-translate>
HTML> # the-draggable-attribute>
HTML> # attr-data-*>
HTML> # the-id-attribute>
HTML> # attr-inputmode>
HTML> # the-title-attribute>
HTML> # attr-contenteditable>
HTML> # attr-contenteditable-plaintextonly>
HTML> # attr-slot>
HTML> # attr-enterkeyhint>
HTML> # attr-lang>
HTML> # inert-subtrees>
HTML> # attr-autocorrect>
HTML> # attr-popover-hint>
HTML> # attr-tabindex>
HTML> # the-style-attribute>
HTML> # attr-nonce>
HTML> # writing-suggestions>
HTML> # the-inert-attribute>
HTML> # the-accesskey-attribute>
HTML> # the-autofocus-attribute>
HTML> # the-dir-attribute>
Модуль CSS Shadow, уровень 1> # part-attr>
Модуль CSS Shadow, уровень 1> # element-attrdef-html-global-exportparts>
DOM> # ref-for-dom-element-slot①>
API виртуальной клавиатуры> # dom-elementcontenteditable-virtualkeyboardpolicy>
Атрибуты стилей CSS> # style-attribute>

Совместимость с браузерами

	Настольные компьютеры					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome для Android	Firefox для Android	Opera для Android	Safari на iOS	Samsung Internet	WebView для Android	WebView на iOS
`accesskey`	1	12	1	15	≤4	18	4	14	≤3.2	1.0	4.4	≤3.2
`anchor`	предварительная версия	Нет	Нет	Нет	Нет	Нет	Нет	Нет	Нет	Нет	Нет	Нет
`autocapitalize`	43	79	111	30	Нет	43	111	30	5	4.0	43	5
`autocorrect`	Нет	Нет	136	Нет	14.1	Нет	136	Нет	14.5	Нет	Нет	14.5
`autofocus`	79 1–79 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	79 12–79 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	110 1–110 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	66 ≤12.1–66 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	15.4 4–15.4 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	79 18–79 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	110 4–110 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	57 ≤12.1–57 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	16.4 Если аппаратная клавиатура не подключена, атрибут `autofocus` не действует (например, событие `focus` не возникает, а элемент не соответствует селектору `:focus`).	12.0 1.0–12.0 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	79 4.4–79 Поддерживается для элементов `<button>`, `<input>`, `<select>` и `<textarea>`.	16.4 Если аппаратная клавиатура не подключена, атрибут `autofocus` не действует (например, событие `focus` не возникает, а элемент не соответствует селектору `:focus`).
`class`	1	12	1	15	≤4	18	4	14	≤3.2	1.0	4.4	≤3.2
`contenteditable`	1	12	3	9	≤4	18	4	14	≤3.2	1.0	4.4	≤3.2
`data_attributes`	7	12	6	15	5.1	18	6	14	5	1.0	4.4	5
`dir`	1	≤15	1	15	≤4	18	4	14	≤3.2	1.0	4.4	≤3.2
`draggable`	4	12	2	12	5	18	4	14	4.2	1.0	4.4	4.2
`enterkeyhint`	77	79	94	66	13.1	77	94	57	13.4	12.0	77	13.4
`exportparts`	73	79	72	60	13.1	73	79	52	13.4	11.0	73	13.4
`hidden`	10	12	4	15	5.1 Этот атрибут не действует для элементов `<option>`.	18	4	14	5 Этот атрибут не действует для элементов `<option>`.	1.0	4	5 Этот атрибут не действует для элементов `<option>`.
`id`	1	12	32 1–32 `id` является настоящим глобальным атрибутом только начиная с Firefox 32.	15	1	18	32 4–32 `id` является настоящим глобальным атрибутом только начиная с Firefox для Android 32.	14	1	1.0	4.4	1
`inert`	102	102	112	88	15.5	102	112	70	15.5	19.0	102	15.5
`inputmode`	66	79	9517–23	53	12.1	66	79	47	12.2 До iOS 13 `inputmode="none"` не действовал.	9.0	66	12.2 До iOS 13 `inputmode="none"` не действовал.
`is`	67	79	63	54	Нет	67	63	48	Нет	9.0	67	Нет
`lang`	1	12	1	15	≤4	18	4	14	≤3.2	1.0	4.4	≤3.2
`nonce`	61	79	75 31–75 Firefox не предотвращает утечку `nonce` через атрибуты содержимого.	48	15.5 15.4–15.5 Safari не предотвращает утечку `nonce` через атрибуты содержимого.	61	79 31–79 Firefox для Android не предотвращает утечку `nonce` через атрибуты содержимого.	45	15.5 15.4–15.5 Safari на iOS не предотвращает утечку `nonce` через атрибуты содержимого.	8.0	61	15.5 15.4–15.5 WebView на iOS не предотвращает утечку `nonce` через атрибуты содержимого.
`part`	73	79	72	60	13.1	73	79	52	13.4	11.0	73	13.4
`popover`	114	114	125	100	17	114	125	76	17	23.0	114	17
`slot`	53	79	63	40	10	53	63	41	10	6.0	53	10
`spellcheck`	9	12	2	15	5.1	47 18–47 Поддерживается только в `<textarea>`.	57 4–57 Поддерживается только в `<textarea>`.	37 14–37 Поддерживается только в `<textarea>`.	9.3 5–9.3 Поддерживается только в `<textarea>`.	5.0 1.0–5.0 Поддерживается только в `<textarea>`.	47 4.4–47 Поддерживается только в `<textarea>`.	9.3 5–9.3 Поддерживается только в `<textarea>`.
`style`	1	12	1	15	1	18	4	14	1	1.0	4.4	1
`tabindex`	1	12	1.5	15	3.1	18	4	14	2	1.0	4.4	2
`title`	1	12	1	15	≤4	18	4	14	≤3.2	1.0	4.4	≤3.2

`translate`	19	79	111	15	6	25	111	14	6	1.5	4.4	6
`virtualkeyboardpolicy`	94	94	Нет	80	Нет	94	Нет	66	Нет	17.0	94	Нет
`writingsuggestions`	124	124	Нет	110	18	124	Нет	82	18	27.0	124	18

См. также

Element интерфейс, позволяющий запрашивать большинство глобальных атрибутов.

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes