Доступность в Jetpack Compose

Доступность имеет решающее значение для создания инклюзивных приложений, которыми может пользоваться каждый. Compose предоставляет основу для создания доступных пользовательских интерфейсов, которые сделают ваши приложения доступными для всех и везде.

Ключевые понятия

  • Семантика: система представления значения элементов пользовательского интерфейса для служб доступности. Сюда входят такие свойства, как описания, состояния и действия, которые может выполнять пользователь.

  • Обход: порядок, в котором службы специальных возможностей, такие как TalkBack, перемещаются по элементам на экране. Вы можете настроить этот порядок для лучшего взаимодействия с пользователем.

  • Действия специальных возможностей: определенные действия, которые пользователь может выполнять с элементом пользовательского интерфейса, например щелчок, прокрутка и закрытие. Ваше приложение передает их службам доступности.

Начать

Основой модели и инструментов доступности Compose является семантика . Дополнительную информацию см. в руководстве «Семантика в Compose» .

При разработке приложения с самого начала помните об этих ключевых шагах по улучшению доступности вашего приложения Compose:

  • Учитывайте минимальные размеры сенсорных объектов . Убедитесь, что кликабельные и интерактивные элементы имеют размер не менее 48 dp. Это соответствует рекомендациям по доступности Material Design.
  • Добавьте метки кликов . Опишите поведение щелчка с помощью модификатора clickable или модификатора semantics , если у вас нет прямого доступа к clickable .
  • Опишите визуальные элементы . Используйте параметр contentDescription для текстового описания значков и изображений. Установите для contentDescription значение null для декоративных элементов.
  • Определить заголовки . Используйте свойство модификатора semantics , чтобы пометить элементы как заголовки для упрощения навигации.
  • Управляйте порядком обхода . Используйте isTraversalGroup , чтобы отметить группы элементов, которые следует читать вместе. Используйте traversalIndex для дальнейшей настройки порядка элементов в этих группах.

Дополнительные сведения см. в специальном руководстве «Ключевые шаги по улучшению специальных возможностей Compose» .

Инструменты

  • TalkBack : программа чтения с экрана Google для Android. Активируйте его, чтобы проверить, как семантика вашего приложения работает для пользователей, использующих вспомогательные технологии.
  • Инспектор макета : визуализируйте и отлаживайте семантическое дерево вашего приложения.
  • API-интерфейсы тестирования Compose . Создавайте тесты, которые взаимодействуют с семантическими элементами, чтобы подтвердить доступность ваших пользовательских интерфейсов Compose.

Кодлаб

Чтобы узнать больше о поддержке специальных возможностей в коде Compose, посетите лабораторную работу «Доступность в Jetpack Compose» .

Дополнительные ресурсы