Глобальні атрибути

{{HTMLSidebar("Global_attributes")}}

Глобальні атрибути – атрибути, що є спільними для всіх елементів 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

Надає підказку для створення комбінації клавіш для поточного елемента. Цей атрибут складається з розділеного пробілами списку символів. Браузер повинен використовувати перший з них, що існує в розкладці клавіатури комп'ютера.

autocapitalize

Контролює те, чи додаються великі літери до тексту, введеного у поля вводу, а також, якщо так, то яким чином.

autofocus

Вказує, що елемент повинен отримати фокус при завантаженні сторінки, або щойно <dialog>, частиною якого є елемент, був показаний. Цей атрибут – булів, початково – хибний.

class

Розділений пробілами список класів елемента. Класи дають змогу CSS і JavaScript обирати й звертатися до певних елементів за допомогою класових селекторів чи функцій, як то метода Document.getElementsByClassName().

contenteditable

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

• true чи порожній рядок, що вказує, що елемент повинен бути редагованим;
• false, що вказує, що елемент повинен бути не редагованим.

data-*

Утворює клас атрибутів, що звуться користувацькими атрибутами даних, котрі дають змогу обмінюватись власною інформацією між HTML та її представленням у DOM, котру можуть використовувати сценарії. Такі користувацькі дані – доступні через інтерфейс HTMLElement елемента, на котрому задано такий атрибут. Доступ до них надає властивість HTMLElement.dataset.

dir

Атрибут, що вказує напрям тексту елемента. Може мати наступні значення:

• ltr, що означає left to right – зліва направо і використовується з мовами, що пишуться зліва направо (як то українською);
• rtl, що означає right to left – справа наліво і використовується з мовами, що пишуться справа наліво (як то арабською);
• auto, що дає користувацькому агентові змогу прийняти рішення. Використовує простий алгоритм, розбираючи символи всередині елемента, поки не зустріне символ з чіткою напрямленістю, а тоді застосовує такий напрям до всього елемента.

draggable

Атрибут, що вказує, чи можна волочити елемент за допомогою API волоку і впуску. Може мати наступні значення:

• true, що вказує: елемент можна волочити
• false, що вказує: елемент не можна волочити.

enterkeyhint

Підказує, який підпис дії (чи піктограму) показувати на клавіші введення віртуальних клавіатур.

exportparts

Використовується для транзитивного експорту тіньових частин зі вкладеного тіньового дерева до контейнерного світлого дерева.

hidden

Перелічений атрибут, що вказує, що елемент поки що, чи уже, не є доречним. Наприклад, може застосовуватися для приховування елементів сторінки, що не можуть використовуватися, поки не завершено процес автентифікації. Браузер не виведе такі елементи. Цей атрибут не повинен використовуватися для приховування вмісту, що може бути правомірно показаний.

id

Визначає унікальний ідентифікатор (ID), що мусить бути унікальним у всьому документі. Його призначення – ідентифікувати елемент у посиланнях (за допомогою фрагмента ідентифікатора), для сценаріїв чи оформлення (засобами CSS).

inert

Булеве значення, котре змушує браузер зневажати на елементі події введення користувача. Корисно, коли присутні події клацання.

inputmode

Надає браузерам підказку щодо того, який тип віртуальної клавіатури використовувати при редагуванні цього елемента чи його вмісту. Використовується перш за все на елементах <input>, але є застосовним до будь-якого елементу, поки він перебуває в режимі contenteditable.

is

Дає змогу вказати, що стандартний елемент HTML повинен поводитись як зареєстрований користувацький вбудований елемент (подробиці у Використанні користувацьких елементів).

Примітка: Атрибути item* є частиною Функціональності мікроданих HTML WHATWG (англ.).

itemid

Унікальний, глобальний ідентифікатор елемента даних.

itemprop

Використовується для додавання до елемента даних властивостей. Кожний елемент HTML може мати атрибут itemprop, що породжує пару імені та значення.

itemref

Властивості, що не є нащадками елемента з атрибутом itemscope, можуть бути пов'язані з елементом даних за допомогою itemref. Цей атрибут надає список id елементів (не itemid) з додатковими властивостями деінде в документі.

itemscope

itemscope (зазвичай) працює разом з itemtype, аби вказати, що HTML всередині блока стосується певного елемента даних. itemscope породжує елемент даних і визначає область дії itemtype, пов'язаного з ним. itemtype – дійсний URL словника (як то schema.org), що описує контекст елемента даних і його властивостей.

itemtype

Задає URL словника, що буде використаний для визначення itemprop (властивостей елемента даних) у структурі даних. itemscope використовується для задання області дії, в межах котрої діятиме структура даних, задана словником з itemtype.

lang

Допомагає з'ясувати мову елемента: мова нередагованих елементів або мова, котрою користувач повинен заповнити редаговані елементи. Атрибут містить один "тег мови" (зроблений з розділених дефісами "підтегів мови") у форматі, визначеному в RFC 5646: Тегах для визначення мов (також відомому як BCP 47). xml:lang має пріоритет над цим тегом.

nonce

Криптографічний однораз ("одноразове число"), що може бути використаний Політикою безпеки вмісту для визначення того, чи буде даному запитові дозволено відбутися.

part

Розділений пробілами список імен частин елемента. Імена частин дають CSS змогу вибирати й оформлювати конкретні елементи в тіньовому дереві за допомогою псевдоелемента ::part.

popover

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

role

Ролі визначають семантичне значення вмісту, даючи читачам з екрана та іншим інструментам представляти й підтримувати взаємодію з об'єктом у спосіб, що узгоджений з очікуваннями користувача щодо об'єкта такого типу. role додаються до елементів 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 – фокус і дотик елемента відв'язані від стану віртуальної клавіатури.

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

Сумісність із браузерами

Дивіться також

• Інтерфейс Element, що дає змогу звертатися до більшості глобальних атрибутів.