Глобальные атрибуты
Глобальные атрибуты являются общими для всех HTML-элементов; они могут использоваться со всеми элементами, хотя на некоторых они могут не оказывать никакого влияния.
Глобальные атрибуты могут быть указаны для всех HTML-элементов, даже тех, которые не указаны в стандарте. Это означает, что любые нестандартные элементы должны поддерживать эти атрибуты, даже если использование этих элементов делает документ несовместимым с HTML5. Например, совместимые с HTML5 браузеры скрывают контент, помеченный как <foo hidden>…</foo>, даже если <foo> не является допустимым HTML-элементом.
Помимо основных глобальных атрибутов HTML, существуют и следующие:
-
xml:langиxml:base— они унаследованы от спецификаций XHTML и устарели, но сохраняются для совместимости. - Атрибут ARIA
roleи множественныеaria-*состояния и свойства, используемые для обеспечения доступности. - Атрибуты обработчиков событий:
onabort,onautocomplete,onautocompleteerror,onblur,oncancel,oncanplay,oncanplaythrough,onchange,onclick,onclose,oncontextmenu,oncuechange,ondblclick,ondrag,ondragend,ondragenter,ondragleave,ondragover,ondragstart,ondrop,ondurationchange,onemptied,onended,onerror,onfocus,oninput,oninvalid,onkeydown,onkeypress,onkeyup,onload,onloadeddata,onloadedmetadata,onloadstart,onmousedown,onmouseenter,onmouseleave,onmousemove,onmouseout,onmouseover,onmouseup,onmousewheel,onpause,onplay,onplaying,onprogress,onratechange,onreset,onresize,onscroll,onseeked,onseeking,onselect,onshow,onsort,onstalled,onsubmit,onsuspend,ontimeupdate,ontoggle,onvolumechange,onwaiting.
Список глобальных атрибутов
accesskey-
Предоставляет подсказку для создания сочетания клавиш для текущего элемента. Этот атрибут состоит из списка символов, разделенных пробелами. Браузер должен использовать первый, который существует на раскладке клавиатуры компьютера.
-
anchorНестандартный -
Связывает позиционированный элемент с элементом якоря. Значение атрибута — значение
idэлемента, к которому вы хотите привязать позиционированный элемент. Затем элемент можно позиционировать с помощью позиционирования с помощью якоря в CSS. autocapitalize-
Управляет тем, как вводимый текст будет автоматически капитализироваться и, если да, то каким образом.
autofocus-
Указывает, что элемент должен быть сфокусирован при загрузке страницы или сразу же, как только
<dialog>, частью которого он является, отобразится. Этот атрибут является булевым, изначально ложным. 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-
Подсказки, какую метку действия (или значок) отображать для клавиши Enter на виртуальной клавиатуре.
exportparts-
Используется для транзитивного экспорта теней части из вложенного дерева теней в содержащее светлое дерево.
-
Атрибут перечисления, указывающий, что элемент ещё не или больше не актуален. Например, его можно использовать для скрытия элементов страницы, которые нельзя использовать до тех пор, пока не будет завершён процесс входа в систему. Браузер не будет отображать такие элементы. Этот атрибут нельзя использовать для скрытия контента, который должен быть отображен.
id-
Определяет уникальный идентификатор (ID), который должен быть уникальным во всем документе. Его цель — идентифицировать элемент при ссылке (с использованием идентификатора фрагмента), программировании или стилизации (с помощью CSS).
inert-
Булевое значение, которое заставляет браузер игнорировать события пользовательского ввода для элемента. Полезно при наличии событий клика.
inputmode-
Предоставляет браузерам подсказку о типе конфигурации виртуальной клавиатуры, которую следует использовать при редактировании этого элемента или его содержимого. В основном используется для элементов
<input>, но может быть использован для любого элемента в режимеcontenteditable. is-
Позволяет указать, что стандартный HTML-элемент должен вести себя как зарегистрированный пользовательский встроенный элемент (подробнее см. Использование пользовательских элементов).
Примечание: Атрибуты item* являются частью функции HTML Microdata от 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-
Помогает определить язык элемента: язык нередактируемых элементов или язык, на котором пользователю следует писать в редактируемых элементах. Атрибут содержит один «языковой тег» (состоящий из разделенных дефисом «языковых подтегов») в формате, определенном в RFC 5646: Теги для идентификации языков (также известны как BCP 47).
xml:langимеет приоритет перед ним. nonce-
Криптографический нонсе (nonce — «используемый один раз»), который может быть использован политикой безопасности содержимого (CSP) для определения, разрешено ли выполнение запроса.
part-
Список имён частей элемента, разделённых пробелами. Имена частей позволяют CSS выбирать и стилизовать определённые элементы в теневом дереве через псевдоэлемент
::part. popover-
Используется для обозначения элемента как элемента всплывающего окна (см. API всплывающих окон). Элементы всплывающего окна скрыты до открытия вызывающим/управляющим элементом (например, элементом
popovertarget) или вызовомHTMLElement.showPopover(). role-
Роли определяют семантическое значение содержимого, позволяя программам чтения с экрана и другим инструментам отображать и поддерживать взаимодействие с объектом способом, соответствующим ожиданиям пользователя от этого типа объекта.
rolesдобавляются к HTML-элементам с помощьюrole="role_type", гдеrole_type— это имя роли в спецификации ARIA. slot-
Присваивает слот в теневом дереве shadow 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, что отсоединяет фокусировку и нажатие на элемент от состояния виртуальной клавиатуры.
-
Технические спецификации
Совместимость с браузерами
| Настольный | Мобильный | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
accesskey |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
anchor |
preview | No | No | No | No | No | No | No | No | No | No |
autocapitalize |
43 | 79 | 111 | 30 | No | 43 | 111 | 30 | 5 | 4.0 | 43 |
autofocus |
791–79Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
7912–79Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
1101–110Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
66≤12.1–66Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
15.44–15.4Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
7918–79Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
1104–110Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
57≤12.1–57Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
15.43.2–15.4Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
12.01.0–12.0Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
79≤37–79Поддерживается для элементов<button>, <input>, <select> и <textarea>. |
class |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
contenteditable |
1 | 12 | 3 | 9 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
data_attributes |
7 | 12 | 6 | 15 | 5.1 | 18 | 6 | 14 | 5 | 1.0 | 4.4 |
dir |
1 | 79 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
draggable |
4 | 12 | 2 | 12 | 5 | 18 | 4 | 14 | 4.2 | 1.0 | 4.4 |
enterkeyhint |
77 | 79 | 94 | 66 | 13.1 | 77 | 94 | 57 | 13.4 | 12.0 | 77 |
exportparts |
73 | 79 | 72 | 60 | 13.1 | 73 | 79 | 52 | 13.4 | 11.0 | 73 |
hidden |
10 | 12 | 4 | 15 | 5.1Этот атрибут не оказывает никакого влияния на элементы<option>. |
18 | 4 | 14 | 5Этот атрибут не оказывает никакого влияния на элементы<option>. |
1.0 | 4 |
id |
1 | 12 | 321–32id является истинно глобальным атрибутом только начиная с Firefox 32. |
15 | 1 | 18 | 324–32id является истинно глобальным атрибутом только начиная с Firefox 32. |
14 | 1 | 1.0 | 4.4 |
inert |
102 | 102 | 112 | 88 | 15.5 | 102 | 112 | 70 | 15.5 | 19.0 | 102 |
inputmode |
66 | 79 | 9517–23 | 53 | 12.1 | 66 | 79 | 47 | 12.2До iOS 13,inputmode="none" не оказывал никакого влияния. |
9.0 | 66 |
invokeaction |
preview | No | preview | No | preview | No | No | No | No | No | No |
invoketarget |
preview | No | preview | No | preview | No | No | No | No | No | No |
is |
67 | 79 | 63 | 54 | No | 67 | 63 | 48 | No | 9.0 | 67 |
lang |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
nonce |
61 | 79 | 31 | 48 | 15.4 | 61 | 31 | 45 | 15.4 | 8.0 | 61 |
part |
73 | 79 | 72 | 60 | 13.1 | 73 | 79 | 52 | 13.4 | 11.0 | 73 |
|---|---|---|---|---|---|---|---|---|---|---|---|
popover |
114 | 114 | 125 | 100 | 17 | 114 | 125 | 76 | 17 | 23.0 | 114 |
slot |
53 | ≤79 | 63 | 40 | 10 | 53 | 63 | 41 | 10 | 6.0 | 53 |
spellcheck |
9 | 12 | 2 | 15 | 5.1 | 47 | 57 | 37 | 9.3 | 5.0 | 47 |
style |
1 | 12 | 1 | 15 | 1 | 18 | 4 | 14 | 1 | 1.0 | 4.4 |
tabindex |
1 | 12 | 1.5 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
title |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
translate |
19 | 79 | 111 | 15 | 6 | 25 | 111 | 14 | 6 | 1.5 | 4.4 |
virtualkeyboardpolicy |
94 | 94 | Нет | 80 | Нет | 94 | Нет | 66 | Нет | 17.0 | 94 |
См. также
-
Elementинтерфейс, который позволяет запросить большинство глобальных атрибутов.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes