{"canonical_url":"https://engineer.company/uk/glossary/aria/","content_markdown":"# ARIA\n\n## Що це таке\n\nARIA — це специфікація W3C, набір атрибутів HTML, які повідомляють допоміжним технологіям, чим є\nелемент сторінки, як він називається і в якому стані перебуває, коли самого HTML для цього замало.\nАбревіатура розшифровується як Accessible Rich Internet Applications, а повна назва специфікації,\nWAI-ARIA, додає до неї Web Accessibility Initiative, ініціативу W3C з вебдоступності. Чинна\nрекомендація W3C має версію 1.2.\n\nАтрибут `role` каже, що це за річ: віджет на кшталт `button` чи `tab`, структурна частина на кшталт\n`list`, одна з восьми ролей-орієнтирів, як-от `navigation` або `main`, чи жива область (live region)\nна кшталт `status`, зміни в якій зчитувач екрана озвучує сам, без запиту. Решта атрибутів `aria-*`\nподіляється на властивості, наприклад `aria-labelledby`, і стани, наприклад `aria-expanded`, які\nзмінюються разом із діями користувача. Браузер переносить усе це в API доступності операційної\nсистеми, а вже звідти інформацію бере зчитувач екрана чи програма голосового керування.\n\nARIA змінює лише те, що буде озвучено. Зчитувач назве `div` з `role=\"button\"` кнопкою, проте фокус\nна такий елемент не потрапляє, а Enter і пробіл нічого не роблять, доки `tabindex` і скрипт не\nдодадуть одне й друге. Тому перше правило використання ARIA в посібнику W3C Using ARIA звучить так:\nякщо вже існує вбудований елемент чи атрибут HTML із потрібними семантикою та поведінкою,\nвикористовуйте його, а не перепрофільовуйте інший елемент, додаючи до нього ARIA.\n\n```html\n\u003c!-- озвучується як кнопка, поводиться як div --\u003e\n\u003cdiv role=\"button\"\u003eНадіслати\u003c/div\u003e\n\n\u003c!-- озвучується, отримує фокус і працює як кнопка --\u003e\n\u003cbutton type=\"button\"\u003eНадіслати\u003c/button\u003e\n```\n\nДруга половина — доступна назва, тобто слова, якими зчитувач екрана називає елемент керування.\nСпецифікація Accessible Name and Description Computation 1.2 задає порядок: спершу\n`aria-labelledby`, далі `aria-label`, потім власна мітка мови розмітки (елемент `label`, атрибут\n`alt`, `title` у SVG), потім текстовий вміст елемента для ролей, які беруть назву з нього, і\nнаостанок атрибут `title`. Отже, `aria-label` на кнопці замінює видимі слова, а не доповнює їх.\n\n## Чому це важливо\n\nARIA ставить перед командою вибір: будувати самим чи взяти готове. Критерій успішності 4.1.2 у WCAG\n2.2, Name, Role, Value, вимагає, щоб кожен компонент інтерфейсу відкривав програмам свою назву й\nроль, дозволяв програмно встановлювати стани та значення, які змінює користувач, і повідомляв про\nїхні зміни. Вбудовані `button`, `select` чи `details` виконують цю вимогу одразу. Власна смуга\nвкладок, комбінований список чи дерево виконують її лише завдяки ARIA і скрипту, який тримає\nатрибути в згоді з дійсністю.\n\nТож власний віджет — це постійні витрати: обробка клавіатури, керування фокусом, стани, що\nвідстежують кожну дію, і тестування з кількома зчитувачами екрана після кожного редизайну. Оцінюючи\nбібліотеку компонентів, з'ясуйте, за яким шаблоном з ARIA Authoring Practices Guide від W3C зроблено\nкожен віджет і чи працює клавіатурна поведінка цього шаблону, коли мишу відкладено.\n\nЮридичний тиск тепер сягає й приватних компаній. Директива про доступність вебсайтів, (ЄС)\n2016/2102, охоплює сайти й мобільні застосунки органів публічного сектору. Директива (ЄС) 2019/882,\nвідома як European Accessibility Act, застосовується з 28 червня 2025 року до низки споживчих\nпродуктів і послуг, серед них електронна комерція та банківські послуги для споживачів, а\nмікропідприємства, що надають послуги, звільнені від її вимог. Обидві спираються на гармонізований\nстандарт EN 301 549, чиї вимоги до вебу — це WCAG рівня AA. Name, Role, Value стоїть на рівні A, тож\nелемент керування, чия назва чи роль лишається прихованою від зчитувача екрана, провалює найнижчий\nрівень, який перевіряє аудитор.\n\n## Як це виглядає на практиці\n\nШаблони цього сайту вдаються до ARIA ощадливо. Верхня панель на кожній внутрішній сторінці — це\n`div` з `role=\"banner\"`, а не звичний елемент `header`. Коментар у шаблоні пояснює чому: таблиця\nстилів оформлює голий `header` як великий вступний блок головної сторінки на всю висоту екрана, тож\nелемент переніс би цю геометрію на кожну внутрішню сторінку, а роль дає орієнтир і більше нічого.\nСаме роль вміщує знак бренду, тобто посилання на головну, всередину орієнтира. Це якраз той вузький\nвипадок, який перше правило допускає. Меню сайту йде протилежним шляхом: це пара `details` і\n`summary`, яка лишає браузерові стан відкриття, семантику кнопки та `aria-expanded`. Елементи `nav`\nменю і футера мають різні значення `aria-label`, бо два навігаційні орієнтири з однією назвою\nпорушують правило унікальності в рушії перевірок, а перевірка доступності сайту вимагає нуля\nзауважень. Збережена в коді реалізація фільтра портфоліо використовує область `role=\"status\"`, яка\nза задумом мовчить, доки читач не почне вводити текст. Зараз цей фільтр вимкнено через\n`searchEnabled = false`; він ілюструє збережену реалізацію, а не взаємодію, доступну на\nопублікованих сторінках.\n\nОпис того, як\n[сайт довели до WCAG 2.2 рівня AA](/uk/portfolio/a-site-that-meets-the-accessibility-standard/),\nдописує другу половину історії верхньої панелі: щойно в рушії перевірок увімкнули правила найкращих\nпрактик, одне з них одразу дало збій, бо на кожній внутрішній сторінці знак бренду лишався за межами\nвсіх орієнтирів. Та сама сторінка серед обмежень, які вона публікує, називає відсутність тестування\nз реальними допоміжними технологіями.\n\nРозбір\n[одинадцяти дефектів, які браузер визнав справними](/uk/portfolio/the-accessibility-faults-your-checker-misses/),\nпоказує, як далеко розмітка від того, що відчуває користувач. Усі одинадцять жили в тому, як\nсторінка малювалася на екрані, а не в тому, що оголошувала розмітка, а розмітка — це все, чого\nторкається ARIA. Вісім посилань у футері й далі були досяжні клавішею Tab, хоча стиль вимкнув для\nних взаємодію з вказівником і більше нічого не змінив. Це та сама схема, що й `aria-hidden` на\nелементі, здатному отримати фокус: зчитувач екрана елемент втрачає, а клавіатура досі до нього веде.\nДо того ж у рушії було ввімкнено лише 70 правил зі 105, і правило, що мало б помітити відсутній\nорієнтир, опинилося серед вимкнених.\n\nОстання сторінка показує ту саму проблему на платформі, де ARIA немає зовсім.\n[Усі сімнадцять іконок інтерфейсу отримали назви для зчитувачів екрана](/uk/portfolio/named-all-17-icons-for-screen-readers/)\n— це історія застосунку на SwiftUI, де немає ні HTML, ні жодного атрибута `aria-`. Мітка доступності\nтам належить самому SwiftUI: це вбудований відповідник `aria-label`, а не його різновид. Елементи\nкерування, намальовані системними символами, зачитувалися внутрішньою назвою символу, тож кнопка\nнадсилання звучала як «стрілка вгору коло, кнопка», а сімнадцять елементів керування з самою іконкою\nописували свій малюнок замість своєї функції. Кожен отримав мітку, що називає дію і там, де це\nважливо, стежить за станом, а лінтер тепер відхиляє елемент керування з іконкою, якщо мітки немає в\nмежах восьми рядків від місця, де його створено, тож вісімнадцятий потрапить у застосунок лише з\nміткою. Сторінка сама називає межу, і вона стосується й `aria-label`: перевірка підтверджує, що\nякась мітка стоїть поблизу, а чи вона правильна, може вирішити лише людина, яка її слухає.\n\n## Де виникають проблеми\n\n**Роль обіцяє віджет, до якого клавіатура не дістає.** Елемент `div` отримує `role=\"button\"` і\nобробник кліку. Зчитувач екрана каже «кнопка», але Tab його проминає, а Enter нічого не робить.\nТретє правило використання ARIA вимагає, щоб кожен інтерактивний елемент керування з ARIA працював\nіз клавіатури. Візьміть вбудований елемент або побудуйте всю клавіатурну модель шаблону з APG і\nтестуйте з від'єднаною мишею.\n\n**Фокус потрапляє на те, що зчитувач екрана вважає відсутнім.** Атрибут `aria-hidden=\"true\"` стоїть\nна елементі, здатному отримати фокус, або на його предкові, наприклад на висувній панелі за межами\nекрана. Tab і далі веде туди, а користувач чує тишу. Четверте правило використання ARIA прямо це\nвиключає. Прибирайте прихований вміст і з порядку табуляції за допомогою `hidden`, `display: none`\nабо `inert`, а `aria-hidden` лишайте для оздоблення, яке ніколи не отримує фокусу.\n\n**Назва потрапляє туди, де елемент її не приймає.** Атрибут `aria-label` на `div`, `span` чи `p` мав\nби щось пояснити, але WAI-ARIA 1.2 забороняє давати назву ролям `generic` і `paragraph`, тож\nзчитувачі екрана її ігнорують або читають непослідовно. На елементі керування мітка замінює видимі\nслова, і коли вони розходяться, користувач голосового керування промахується, вимовляючи те, що\nбачить на екрані. Давайте назви лише елементам, які можуть її мати, і починайте кожен `aria-label` з\nвидимих слів, як вимагає WCAG 2.5.3, Label in Name.\n\n**Дві ролі суперечать одна одній.** Явна роль замінює власну роль елемента. Посилання з\n`role=\"button\"` озвучується як кнопка, але пробіл на ньому прокручує сторінку; `role=\"tab\"` на `h2`\nприбирає його зі списку заголовків; `role=\"navigation\"` на `ul` позбавляє його ролі списку й\nкількості пунктів. Друге правило використання ARIA — змінювати вбудовану семантику лише тоді, коли\nбез цього не обійтися, а ARIA in HTML перелічує, які ролі може мати кожен елемент.\n\n**Жива область говорить без упину.** Атрибут `aria-live=\"assertive\"` або `role=\"alert\"` стоїть на\nлічильнику результатів чи зворотному відліку, що змінюється з кожним натисканням клавіші чи\nщосекунди, і зчитувач екрана перебиває користувача на кожному новому значенні. Використовуйте\nввічливі оголошення (`polite`), які `role=\"status\"` дає за визначенням, озвучуйте результат, коли\nвведення вщухне, і тримайте область тихою під час завантаження сторінки.\n\n## Що почитати далі\n\n- [WAI-ARIA 1.2](https://www.w3.org/TR/wai-aria-1.2/) — усі ролі, стани й властивості, які атрибути\n  підтримує кожна роль і яким ролям не можна давати назву.\n- [ARIA in HTML](https://www.w3.org/TR/html-aria/) — які ролі й атрибути може мати кожен елемент\n  HTML і які з них зайві.\n- [Using ARIA](https://www.w3.org/TR/using-aria/) — практичний посібник W3C із правилами\n  використання ARIA і прикладом до кожного.\n- [Accessible Name and Description Computation 1.2](https://www.w3.org/TR/accname-1.2/) — алгоритм,\n  що визначає, як зчитувач екрана назве елемент керування.\n- [Understanding Name, Role, Value](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html)\n  — чого критерій успішності 4.1.2 у WCAG 2.2 вимагає від кожного компонента, з техніками й типовими\n  помилками.\n- [ARIA Authoring Practices Guide](https://www.w3.org/WAI/ARIA/apg/) — розмітка й клавіатурна\n  поведінка для кожного поширеного шаблону віджета, з робочими прикладами.\n\n\u003chttps://engineer.company/uk/glossary/aria/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Ролі, стани й назви в ARIA, коли звичайний HTML упорається краще, чого вимагають WCAG 2.2 і право ЄС, та п'ять типових помилок.","formats":{"gemtext":"https://engineer.company/uk/glossary/aria/index.gmi","gopher":"https://engineer.company/uk/glossary/aria/gophermap","html":"https://engineer.company/uk/glossary/aria/","json":"https://engineer.company/uk/glossary/aria/index.json","markdown":"https://engineer.company/uk/glossary/aria/index.md","pdf":"https://engineer.company/uk/glossary/aria/index.pdf"},"kind":"page","language":"uk","title":"Що таке ARIA?","url":"https://engineer.company/uk/glossary/aria/","version":1}