Форма, где дата выбирается только кликом по календарю, недоступна пользователям клавиатуры, экранных дикторов и некоторых мобильных сценариев. Часто проблема появляется из-за div вместо кнопок, потерянного фокуса, перехвата Tab или запрета ручного ввода. Исправление должно сохранить и календарь, и понятный текстовый способ ввода.
Уберите мышь и пройдите форму только клавишами Tab, Shift+Tab, Enter, Escape и стрелками. Фокус должен быть виден, открытие календаря предсказуемо, выбранная дата озвучиваться, а пользователь иметь возможность ввести дату вручную в документированном формате.
Что проверить в первую очередь
Начните с одного воспроизводимого сценария. Зафиксируйте точное время, идентификатор объекта, пользователя или операции, версию приложения и последнее известное рабочее состояние. Не меняйте несколько параметров одновременно: один контролируемый шаг должен подтверждать или исключать одну гипотезу. Перед работой с данными и конфигурацией подготовьте резервную копию и проверенный способ отката.
- Проверьте, можно ли попасть на поле даты и кнопку календаря клавишей Tab.
- Убедитесь, что видимый focus outline не отключен стилями.
- Проверьте ручной ввод, маску, сообщение об ошибке и локальный формат даты.
- Откройте форму с экранным диктором и прослушайте label, подсказку и состояние.
- Проверьте native date input и кастомный календарь на мобильных браузерах.
Почему возникает проблема
Внешний симптом часто появляется дальше по цепочке, чем первичная ошибка. Интерфейс может показывать неверное состояние из-за backend, очереди, кеша, прав доступа, фоновой задачи или внешнего API. Поэтому важно проследить данные от источника до результата и найти первую точку расхождения, а не исправлять только последнее сообщение об ошибке.
- Дни календаря сделаны неинтерактивными div с обработчиком click.
- Модальное окно не переводит фокус внутрь или не возвращает его на кнопку.
- JavaScript блокирует ручной ввод и принимает только событие выбора мышью.
- Стрелки и Escape не реализованы либо конфликтуют с глобальными hotkeys.
- ARIA-роли добавлены формально, но состояние selected и active descendant не обновляется.
Пошаговая диагностика
Диагностику проводите на тестовой записи или отдельном окружении. В журналах скрывайте токены, пароли, персональные данные и содержимое документов. Для каждого шага сохраняйте измеримый результат: код ответа, версию записи, идентификатор события, состояние процесса, контрольную сумму или время выполнения. Так можно отличить подтвержденную причину от случайного совпадения.
- Составьте последовательность фокуса от предыдущего поля до следующего после даты.
- Проверьте accessibility tree в инструментах браузера.
- Зафиксируйте активный элемент при открытии, выборе, закрытии и ошибке.
- Проверьте поведение при увеличении масштаба до 200 процентов и узком экране.
- Запустите автоматический аудит, но подтвердите результат ручной клавиатурной проверкой.
Ожидаемое клавиатурное поведение календаря
Календарь должен следовать устойчивому паттерну взаимодействия и не превращать каждый день в отдельную остановку Tab.
- Tab переводит фокус на поле и кнопку, а внутри сетки используется один активный день.
- Стрелки перемещают активную дату, Page Up и Page Down меняют месяц по принятому паттерну.
- Enter или Space выбирает дату, Escape закрывает окно без неожиданного изменения.
- Выбранная и недоступные даты имеют программно определимое состояние.
- После закрытия фокус возвращается к элементу, который открыл календарь.
Как исправить проблему
Исправление делите на небольшие обратимые изменения. Сначала устраните подтвержденную причину, затем повторите исходный сценарий и проверьте соседние функции. Массовое обновление данных запускайте на ограниченной выборке с отчетом и только после сверки расширяйте на весь объем. Не отключайте авторизацию, проверку сертификатов, валидацию или аудит ради быстрого исчезновения симптома.
- Сохраните обычное поле с label и разрешите корректный ручной ввод.
- Используйте проверенный доступный datepicker либо native input там, где его поведение подходит.
- Реализуйте управление фокусом и клавишами согласно выбранному ARIA-паттерну.
- Не удаляйте outline; оформите заметный focus-visible в стиле сайта.
- Свяжите ошибку и подсказку с полем через aria-describedby и выводите понятный формат.
Безопасный порядок внедрения
- Сохраните затрагиваемые данные, конфигурацию и текущие журналы, затем проверьте возможность реального восстановления.
- Повторите проблему на тестовом объекте без реальных списаний, рассылок и необратимых изменений клиентских данных.
- Зафиксируйте изменение в системе контроля версий или журнале работ вместе с причиной, ожидаемым эффектом и планом отката.
- Проведите тест на нормальном сценарии, ошибочном вводе, повторном запросе, параллельной операции и временной недоступности зависимости.
- После выпуска наблюдайте полный пользовательский путь, логи и метрики, а не только один успешный запрос.
Как проверить результат
Разовый успешный тест недостаточен. Повторите операцию, проверьте крайние значения, одновременные действия и восстановление после перезапуска или временного сбоя. Для важного сценария сохраните автоматический тест либо короткий регрессионный чек-лист. Итог должен подтверждаться не только интерфейсом, но и состоянием базы, очереди, внешнего сервиса и журналом действий.
- Всю форму можно заполнить и отправить без мыши.
- Экранный диктор объявляет название поля, формат, выбранную дату и ошибки.
- Фокус не исчезает за календарем и возвращается после закрытия.
- Ручной ввод и выбор в календаре дают одинаковое серверное значение.
- Компонент работает при zoom 200 процентов, на малом экране и при увеличенном тексте.
Типичные ошибки при исправлении
- Добавлять tabindex=0 каждому дню и создавать десятки остановок.
- Прятать focus outline без равноценной замены.
- Полагаться только на placeholder вместо постоянного label.
- Использовать цвет как единственный признак выбранной даты или ошибки.
- Считать успешный Lighthouse-аудит полной проверкой клавиатурного сценария.
Как предотвратить повторение
Профилактика строится вокруг явных контрактов, повторяемых релизов и наблюдаемости. Система должна не только работать сейчас, но и позволять быстро увидеть нарушение правила при следующем обновлении, росте нагрузки или сбое внешнего сервиса. Проверки особенно полезно автоматизировать там, где ошибка уже привела к потере времени, данных, денег или заявок.
- Включите клавиатурный сценарий в приемочные тесты каждой формы.
- Создайте единый компонент даты вместо нескольких случайных библиотек.
- Добавьте автоматические проверки доступных имен и фокуса.
- Тестируйте локали, форматы и крайние даты.
- Проводите ручную проверку экранным диктором перед крупными изменениями формы.
Что контролировать после выпуска
- Количество успешных и ошибочных операций в разрезе версии, канала и типа сценария.
- Возраст необработанных записей, длину очередей, число повторных попыток и долю окончательных отказов.
- Расхождение между пользовательским статусом и фактическим состоянием в базе или внешней системе.
- Появление новых кодов ошибок после релиза и изменение времени выполнения ключевой операции.
- Сигналы от поддержки и бизнес-метрики, которые могут показать скрытый частичный сбой.
Что подготовить для технического разбора
- Описание ожидаемого и фактического поведения с точной последовательностью действий.
- Время проблемы, идентификатор тестового объекта и версии затронутых компонентов.
- Фрагменты журналов до и после ошибки без секретов и персональных данных.
- Перечень последних изменений и уже выполненных проверок.
- Безопасный доступ к тестовой среде либо способ воспроизвести сбой без влияния на клиентов.
Частые вопросы
Достаточно ли поставить input type date?
Иногда да, но нужно проверить поддержку формата, ограничений и доступность в целевых браузерах.
Можно ли оставить только ручной ввод?
Можно, если формат понятен и валидация удобна, но календарь часто полезен как дополнительный способ.
Почему Tab не должен обходить все дни?
Это создает слишком длинную навигацию; внутри grid обычно используют стрелки, сохраняя одну активную точку фокуса.
Когда нужна помощь специалиста
Если календарь ломает форму для клавиатуры или мобильных пользователей, я могу проверить компонент, исправить семантику и фокус, сохранить дизайн и добавить регрессионные тесты. Для оценки пришлите URL формы и список поддерживаемых браузеров.