Spec-Zone.ru › HTML

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

Глобальные атрибуты являются общими для всех 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

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

hidden

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

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, что отсоединяет фокусировку и нажатие на элемент от состояния виртуальной клавиатуры.

Технические спецификации

Спецификация
Стандарт HTML
# the-accesskey-attribute
Стандарт HTML
# attr-autocapitalize
Стандарт HTML
# dom-fe-autofocus
Стандарт HTML
# global-attributes:classes-2
Стандарт HTML
# attr-contenteditable
Стандарт HTML
# attr-data-*
Стандарт HTML
# the-dir-attribute
Стандарт HTML
# the-draggable-attribute
Стандарт HTML
# attr-enterkeyhint
CSS Shadow Parts
# element-attrdef-html-global-exportparts
Стандарт HTML
# the-hidden-attribute
Стандарт HTML
# global-attributes:the-id-attribute-2
Стандарт HTML
# the-inert-attribute
Стандарт HTML
# attr-inputmode
Стандарт HTML
# attr-is
Стандарт HTML
# attr-lang
Стандарт HTML
# attr-nonce
CSS Shadow Parts
# part-attr
Стандарт HTML
# the-popover-attribute
Стандарт HTML
# attr-slot
Стандарт DOM
# ref-for-dom-element-slot①
Стандарт HTML
# attr-spellcheck
Стандарт HTML
# the-style-attribute
Стандарт HTML
# attr-tabindex
Стандарт HTML
# the-title-attribute
Стандарт HTML
# attr-translate
API виртуальной клавиатуры
# dom-elementcontenteditable-virtualkeyboardpolicy

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

Настольный Мобильный
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 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>.
15.4
3.2–15.4Поддерживается для элементов <button>, <input>, <select> и <textarea>.
12.0
1.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 32
1–32id является истинно глобальным атрибутом только начиная с Firefox 32.
15 1 18 32
4–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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API