Документація Pandus SDK
Живі бар’єри й що виправити першим
Як Pandus SDK помічає бар’єри в реальних візитах, поєднує їх зі знахідками сканера, визначає порядок виправлень, підтверджує їх і надсилає тижневий дайджест.
Оновлено:
Сканер показує, що зламано в коді. SDK показує, де в це впираються реальні відвідувачі і скільки їх. Разом виходить порядок роботи за реальним трафіком, а після виправлення система сама перевіряє, що сигнал зник.
Як помічаються бар’єри
Кожен детектор стежить за сторінкою в браузері відвідувача й повідомляє сторінку, стабільний селектор і критерій успіху WCAG. Він ніколи не надсилає тексту, значень полів, ID сесії чи клієнта. Сигнали підсумовуються за перегляд у браузері, а на нашому сервері — за шаблоном сторінки й елементом, тож /product/123 і /product/456 рахуються як один шаблон.
| Сигнал | Як помічається | WCAG |
|---|---|---|
| Пастка фокуса | Tab і Shift+Tab ходять по колу з кількох елементів, Esc не виводить, мишею не користувалися | 2.1.2 |
| Втрата фокуса | Після дії (закрили вікно, видалили елемент) фокус на body сторінки | 2.4.3 |
| Невидимий фокус | Елемент у фокусі виглядає так само, як без фокуса | 2.4.7, 2.4.11 |
| Фокус під перекриттям | Липка шапка чи банер закриває елемент у фокусі | 2.4.11 |
| Стрибок порядку фокуса | Наступний фокус стрибає проти візуального потоку | 2.4.3 |
| Елемент без семантики | Клік по елементу з курсором-вказівником, але без ролі, tabindex і назви | 4.1.2, 2.1.1 |
| Фокус у прихованому вмісті | Фокус у частині з aria-hidden |
4.1.2 |
| Неоголошені помилки форм | Невалідні поля без aria-invalid чи пов’язаного повідомлення; повторні невдалі надсилання |
3.3.1, 3.3.3 |
| Перекомпонування й масштаб | Горизонтальна прокрутка на 320 CSS px чи при масштабуванні; обрізаний текст | 1.4.10, 1.4.4 |
| Автозапуск | Відео чи аудіо зі звуком стартує без дії | 1.4.2 |
| Живий axe | axe-core на вибірці реальних станів сторінки, див. Розширення й живий axe | за правилом |
| Повідомлення про бар’єри | Форма «Повідомити про бар’єр», пов’язана зі сторінкою та її сигналами | — |
Rage- і мертві кліки показуються поруч із бар’єрами як підказка, без критерію WCAG. Посилання «перейти до вмісту», яким користуються відвідувачі, рахується як позитивний сигнал.
Один список «що виправити»
Що виправити поєднує проблеми з чотирьох джерел: сканер, живі відвідувачі, розширення й повідомлення про бар’єри. У кожної проблеми бейджі джерел. Знахідка сканера й живий сигнал на тій самій сторінці чи шаблоні, з тим самим селектором і критерієм WCAG стають однією проблемою з бейджем «підтверджено реальними відвідувачами: N сесій за 7 днів».
Фільтруйте за статусом, сторінкою, критерієм WCAG, серйозністю й виконавцем; змінюйте багато проблем одразу.
Пріоритет
Пріоритет = вага серйозності × частка зачеплених сесій × трафік сторінки × коефіцієнт підтвердження (сканер і відвідувачі разом) × коефіцієнт повідомлень про бар’єри. Бар’єр на кроці перед ключовою подією піднімається вгору. Угорі списку видно очікуваний ефект, наприклад «зачіпає ~12 % відвідувань сторінки кошика». Поради обирають правила й картки правил; ШІ не використовується.
Картка проблеми
- Що це й чому важливо для бізнесу — з картки правила сімома мовами.
- Де трапляється: сторінки й шаблони з їхнім трафіком.
- Докази: скриншот і селектор зі сканера, графік живих сигналів, записи з цим бар’єром, фрагмент теплової карти, повідомлення відвідувачів.
- Як виправити в Shopify, WooCommerce, PrestaShop, Shoptet і в коді.
- Статус, виконавець і коментарі команди.
- Перевірити виправлення: сканер перевіряє знову, а живий трафік під наглядом. Показати на сайті відкриває сторінку в розширенні з підсвіченим елементом.
Статуси
Відкрито → у роботі → виправлено → підтверджено, коли живий сигнал тримається нижче порога задану кількість днів, або повернулося, коли він з’являється знову. Проблему можна приховати з причиною.
Індекс здоров’я
Оцінка від 0 до 100 зі сканера й живих бар’єрів у шапці сайту, з формулою в один клік і трендом.
Екран «Живі бар’єри»
Сигнали за типами й сторінками з трендами, карта клавіатури (куди люди доходять клавішею Tab і де зупиняються) та налаштування відображення лише агреговано, якщо за ними щонайменше 20 сесій.
Повідомлення про бар’єри
Публічна форма «Повідомити про бар’єр» питає крок за кроком, простими словами, зі скриншотом за бажанням. У кабінеті повідомлення мають статуси (нове, у роботі, вирішено, спам), пов’язуються з проблемами й записами сторінки, ви можете відповісти відвідувачу, який залишив e-mail і дав згоду, або додати бар’єр вручну.
Дайджест і сповіщення
Раз на тиждень, на e-mail і в Telegram: нові бар’єри, що підтверджено виправленим, і сплески. Різке зростання сигналу одразу надсилає сповіщення; поріг — у налаштуваннях.
Pandus SDK і сканер — це автоматичні перевірки, не повний аудит і не юридична консультація. SDK нічого не змінює на сайті й не визначає, хто з відвідувачів користується допоміжними технологіями.