Перейти до вмісту
Pandus

Тестування доступності вебзастосунків: чим відрізняється від сайту

Вебзастосунок тестують за тим самим стандартом, що й сайт, WCAG 2.2 AA, але його проблеми ховаються в станах, до яких краулер ніколи не дістається: діалог, змінений маршрут, сповіщення, відфільтрована таблиця за логіном. Робочий план має чотири шари: автоматичні перевірки в CI на реальних станах, перевірки сторінок після входу в браузері, короткий сценарій із клавіатурою й живі сигнали від користувачів.

Автор: , засновник Pandus · Оновлено 21 жовтня 2026 · 5 хв читання · Як ми пишемо й перевіряємо наші посібники

На сайті одиниця — сторінка: ви відкриваєте URL, вміст на місці, перевірка його читає. У вебзастосунку одиниця — стан. Той самий URL показує порожній список, індикатор завантаження, відфільтровану таблицю або помилку залежно від того, що зробив користувач. Сторінка входу — єдине, що бачить краулер, і проблеми рідко саме там.

Цей посібник для команд, які будують SaaS-продукти, портали й внутрішні інструменти. Він передбачає, що ви знаєте чекліст WCAG 2.2 і хочете знати, куди його спрямувати.

Де ламаються вебзастосунки

Шість місць дають більшість блокерів, які ми бачимо в застосунках:

  1. Зміна маршруту без керування фокусом. В односторінковому застосунку змінюється URL, змінюється вміст, а фокус лишається на посиланні, якого вже немає. Користувач скринрідера не чує нічого. Виправлення: переміщати фокус на заголовок або головну область нового екрана й оновлювати заголовок документа.
  2. Діалоги. Діалог має отримати фокус при відкритті, утримувати Tab усередині, закриватися по Escape і повертати фокус на елемент, який його відкрив. Більшість власних діалогів провалюють хоча б одне з цього; див. патерн модального діалогу.
  3. Сповіщення й живі оновлення. Повідомлення, що на три секунди з’являється в кутку, невидиме для скринрідера, якщо воно не в live-регіоні. Повідомлення про статус — це критерій WCAG 2.2 (4.1.3).
  4. Власні елементи керування. Комбобокси, вибір дати, повзунки й перемикачі, зібрані з div, не мають ролі, назви й поведінки з клавіатури, доки хтось їх не додасть. Патерн select і комбобокса показує очікувану поведінку.
  5. Таблиці й списки з діями. Рядок кнопок-іконок (редагувати, видалити, завантажити) без доступної назви читається як «кнопка, кнопка, кнопка». Віртуалізовані списки, що рендерять лише видимі рядки, плутають скринрідери, які читають весь список.
  6. Форми з миттєвою перевіркою. Помилки, що з’являються біля поля, але не пов’язані з ним, або оголошуються раніше, ніж користувач закінчив вводити. Патерн помилок форм описує зв’язки.

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

Шар 1: автоматичні перевірки в CI на реальних станах

Запускайте відкритий рушій axe-core у наскрізних тестах у тому стані, який хочете перевірити: після входу, після відкриття діалогу, після застосування фільтра. Playwright із @axe-core/playwright — звичний набір; у нашому посібнику про тести доступності з Playwright є код і набір правил, що збігається зі сканером Pandus, тож CI і щотижнева перевірка не розходяться.

Три звички роблять це корисним, а не шумним:

  • Валіть збірку лише на результатах serious і critical; решту лишайте як звіт.
  • Тестуйте стани, а не сторінки: один тест на діалог, на порожній стан, на стан помилки.
  • Перевіряйте заголовок документа й фокус після кожної зміни маршруту в тому самому тесті.

Шар 2: екрани після входу в браузері

CI покриває те, що ви вирішили протестувати. Розширення Pandus покриває те, що у вас відкрито зараз: тестове середовище, адмінку, кабінет клієнта з реальними даними. Воно запускає ті самі правила, пояснює кожну проблему простими словами й копіює нотатку для розробника або промпт для AI-асистента. Інструменти порядку Tab і фокуса показують порядок, із яким зіткнуться користувачі клавіатури, а це найчастіша несподіванка в застосунку.

Шар 3: десять хвилин із клавіатурою

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

  1. Від’єднайте мишу, відкрийте сторінку входу й увійдіть лише Tab і Enter. Чи видно на кожному кроці, де ви?
  2. Відкрийте головний діалог продукту. Чи переміщується в нього фокус? Чи закриває його Escape і повертає вас назад?
  3. Викличте повідомлення про успіх і помилку. З увімкненим скринрідером (NVDA, VoiceOver) — чи оголошуються вони?
  4. Скористайтеся головною таблицею чи списком: відсортуйте, відфільтруйте, відкрийте рядок, виконайте дію в рядку. Чи знадобилася десь миша?
  5. Змініть маршрут через навігацію. Де тепер фокус і що каже заголовок?

Там, де застрягли ви, застрягають і користувачі з клавіатурою, перемикачем або скринрідером. Запишіть п’ять відповідей: це ручна частина вашої сторінки про доступність.

Шар 4: живі сигнали від реальних користувачів

Три шари вище тестують те, що ви вирішили протестувати. Pandus SDK повідомляє, з чим користувачі зіткнулися насправді: фокус клавіатури застряг на екрані, фокус загубився після закриття діалогу, елемент без назви, на який люди клікали знову й знову, помилка форми, яку так і не оголосили, верстка, що зламалася при збільшенні. Кожен сигнал несе сторінку, елемент і критерій WCAG, а сигнали рахуються, тож перше виправлення — те, що зачіпає найбільше користувачів. На вибірці переглядів SDK також запускає axe-core на реальному стані застосунку, замінюючи всі тексти до того, як щось покине браузер.

Після виправлення сканер перевіряє знову, а живий сигнал спостерігається задану кількість днів. «Підтверджено реальними відвідувачами» — кращий статус, ніж «закрито».

Що записати

Покупці вебзастосунків просять підтвердження. Тримайте актуальними три речі:

  • Сторінку про доступність із датою останньої перевірки, стандартом (WCAG 2.2 AA), відомими обмеженнями і способом повідомити про бар’єр. У посібнику із заяви про доступність є шаблон; Pandus формує чернетку з анкети.
  • Accessibility Conformance Report у форматі VPAT, якщо серед ваших клієнтів є органи влади чи великі організації. Pandus формує чернетку з автоматичної перевірки на тарифах Agency; ручні колонки потребують людини.
  • Список відкритих проблем із відповідальними й датами, експортований у Jira або GitHub, щоб наступний спринт його мав.

Автоматичні перевірки, розширення і SDK знаходять частину проблем; сценарій із клавіатурою й ручна перевірка знаходять решту. У кожному звіті ми кажемо, що це автоматична перевірка, а не повний аудит, і ніщо тут не є юридичною консультацією.

Посібники та інструменти

Статті довідки