Учебник Axe-core

Введение
- Что такое axe-core
- История и развитие проекта
- Основные возможности и преимущества
- Сравнение с альтернативными решениями
- Системные требования и совместимость
Установка и настройка окружения
- Установка через npm
- Установка через yarn
- Подключение через CDN
- Интеграция в существующий проект
- Настройка TypeScript
- Конфигурация для различных сборщиков
Базовые концепции
- Архитектура библиотеки
- Правила доступности и их структура
- Теги и стандарты WCAG
- Уровни соответствия A, AA, AAA
- Контекст выполнения проверок
- Результаты проверок и их интерпретация
Первый запуск
- Простейший пример использования
- Анализ целой страницы
- Анализ отдельного элемента
- Чтение результатов violations
- Работа с passes и incomplete
- Обработка inapplicable результатов
API библиотеки
- Метод axe.run
- Параметры context
- Параметры options
- Возвращаемые промисы
- Метод axe.configure
- Метод axe.getRules
- Метод axe.reset
- Вспомогательные методы
Конфигурация правил
- Структура объекта конфигурации
- Включение и отключение правил
- Настройка отдельных правил
- Изменение уровней серьезности
- Работа с тегами правил
- Фильтрация по стандартам
- Глобальная конфигурация
Контекст выполнения
- Селекторы CSS
- Объекты include и exclude
- Работа с iframe
- Shadow DOM
- Динамический контент
- Ограничение области проверки
Опции выполнения
- Параметр runOnly
- Параметр rules
- Параметр reporter
- Параметр resultTypes
- Параметр selectors
- Параметр ancestry
- Параметр xpath
- Дополнительные опции
Работа с результатами
- Структура объекта результатов
- Анализ violations
- Интерпретация passes
- Обработка inapplicable
- Информация о нодах
- Данные about проверки
- Timestamp и окружение
Violations и их обработка
- Структура объекта violation
- Поля id, impact, tags
- Массив nodes
- Данные any, all, none
- HTML и селекторы
- Формирование отчетов
Incomplete результаты
- Ручная проверка требований
- Рекомендации по устранению
- Работа с неоднозначными случаями
- Документирование решений
Кастомные правила
- Создание собственных правил
- Структура правила
- Metadata правила
- Функция matches
- Определение checks
- Типы checks: any, all, none
- Регистрация правила
Кастомные проверки
- Создание кастомных checks
- Функция evaluate
- Параметры node и options
- Возвращаемые значения
- Сообщения и данные
- Регистрация проверок
Локализация
- Поддержка мультиязычности
- Настройка локали
- Перевод сообщений
- Кастомные переводы
- Структура языковых файлов
Интеграция с фреймворками
- Использование в React
- Интеграция с Vue.js
- Работа с Angular
- Применение в Svelte
Интеграция с тестовыми фреймворками
- Jest и axe-core
- Mocha и Chai
- Jasmine
- Cypress и axe-core
- Playwright
- Puppeteer
- Selenium WebDriver
Автоматизация проверок
- Непрерывная интеграция
- Настройка CI/CD pipeline
- GitHub Actions
- Jenkins
- Пороговые значения
- Блокировка при нарушениях
Производительность
- Оптимизация выполнения
- Выборочный запуск правил
- Параллельное выполнение
- Кэширование результатов
- Профилирование
Отладка и диагностика
- Режим debug
- Логирование процесса
- Анализ проблемных правил
- Воспроизведение ошибок
- Инструменты разработчика
Отчеты
- Форматы отчетов
- JSON reporter
- CSV reporter
- HTML reporter
- Кастомные репортеры
- Визуализация результатов
- Экспорт данных
Accessibility DevTools
- Браузерные расширения
- Интеграция с DevTools
- Инспектирование элементов
- Живой анализ
- Взаимодействие с axe-core
Работа с динамическим контентом
- Single Page Applications
- Проверка после событий
- MutationObserver
- Отложенная загрузка контента
Shadow DOM и Web Components
- Особенности теневого DOM
- Настройка проверки
- Ограничения и обходные пути
- Пользовательские компоненты
Iframe и кросс-доменный контент
- Проверка вложенных фреймов
- Ограничения безопасности
- Same-origin policy
- Настройка доступа
- Стратегии тестирования
Расширенная конфигурация
- Приоритизация правил
- Составные конфигурации
- Профили проверок
- Окружение-специфичные настройки
- Версионирование конфигураций
Интеграция с инструментами аудита
- Pa11y
- Комплексный подход
Мониторинг доступности
- Регулярные проверки
- Отслеживание метрик
- Уведомления о проблемах
Обработка ошибок
- Try-catch блоки
- Обработка отклоненных промисов
- Таймауты
- Логирование ошибок
Продвинутые техники
- Частичные проверки
- Инкрементальный анализ
- Diff результатов
Оптимизация рабочих процессов
- Разделение проверок
- Приоритетные правила
- Стратегии для больших приложений
Документирование результатов
- Шаблоны отчетов
- Трекинг исправлений
Стандарты и спецификации
- WCAG 2.1 и 2.2
- Section 508
- ARIA спецификации
- Соответствие стандартам
Лучшие практики
- Организация тестов
- Структура проекта
- Code review доступности
- Обучение команды
- Процессы и workflow
Миграция между версиями
- Обновление axe-core
- Breaking changes
- Совместимость API
- Обновление конфигураций
- Тестирование после миграции
Устранение распространенных проблем
- Частые ошибки конфигурации
- Проблемы с селекторами
- Конфликты правил
- Производительные узкие места