Адаптивность и доступность
Требования к клавиатуре, фокусу, касаниям и мобильным устройствам для компонентов Qokit и расширений платформы.
Адаптивность и доступность
Все публичные компоненты и интерфейсы интеграции должны одновременно поддерживать работу с клавиатурой, касаниями и текстами разной длины. На мобильных устройствах макет должен перестраиваться в зависимости от задач, а не просто уменьшаться по сравнению с десктопной версией.
Клавиатура и фокус
- Используйте семантические Button, Link, Label, Heading, Table и List;
- Все взаимодействия должны быть доступны и управляемы с клавиатуры;
- Используйте общие
focus-visibleи--focus-ring, нельзя удалять визуальную обратную связь при фокусе; - IconButton должен предоставлять локализованный
aria-label; - Tooltip может только дополнять информацию, но не заменять доступное имя.
Касания и состояния
- Область нажатия компактных элементов управления должна быть не менее 40px, основные действия на мобильных устройствах — не менее 44px;
- Hover не должен быть единственным источником подсказок;
- Состояния Disabled, Loading, Empty и Error должны иметь понятную обратную связь;
- Опасные действия требуют четкого текста и процесса подтверждения, нельзя полагаться только на красный цвет.
Адаптивный макет
- На планшетах и ниже многоколоночные интерфейсы должны переключаться на одноколоночный вид, сворачиваться или открываться в виде выдвижной панели в зависимости от приоритета задач;
- Размеры Header, Toolbar, таблиц, окон предварительного просмотра и групп действий должны оставаться стабильными;
- Длинные метки, переведенный текст и пользовательский контент не должны перекрывать соседние действия;
- На десктопе и мобильных устройствах необходимо проверять реальное содержимое, порядок фокуса и горизонтальное переполнение.
Контент и контрастность
- Основной текст, пояснения и CTA должны оставаться читаемыми на светлом, темном и тематизированном фоне;
- Для изображений предоставляйте альтернативный текст, соответствующий содержанию;
- Состояния не должны передаваться только через цвет;
- Анимации должны уважать
prefers-reduced-motion, ключевые процессы не должны зависеть от завершения анимации.