Skip to Content
Дизайн

Адаптивность и доступность

Требования к клавиатуре, фокусу, касаниям и мобильным устройствам для компонентов 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, ключевые процессы не должны зависеть от завершения анимации.

На этой странице