---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.3
alternate:
  - https://divkit.tech/docs/en/concepts/accessibility.md
  - https://divkit.tech/docs/ru/concepts/accessibility.md
---
> **Documentation Index:** Fetch the complete configuration index at https://divkit.tech/docs/ru/llms.txt

# Поддержка доступности

Мы стараемся как можно больше упростить поддержку доступности. DivKit автоматически проставляет правильные типы в соответствии с платформой таким объектам, как `text`, `input`, `select`, `slider` и `tabs`. Но мы не можем дать пользователю дополнительную информацию, задать корректное описание (`description`) и т.&nbsp;п. Поэтому `image` и `separator` по умолчанию исключены из доступности.

Если элемент имеет действия на нажатие (одинарное или двойное)&nbsp;— это также будет автоматически озвучено accessibility-сервисом.

Для настройки доступности можно использовать объект `accessibility`. Пример:

``` json
"accessibility": {
       "type": "button",
       "hint": "Tap on the button to play music.",
       "description": "Play music",
       "state_description": "Clicked",
       "is_checked": true,
       "mode": "merge"
 }
```

- `type`&nbsp;— роль элемента. Используется для правильной идентификации элемента accessibility-сервисом.
- `hint`&nbsp;— подсказка, что произойдет при взаимодействии. Читается после `description`.
- `description`&nbsp;— основное описание элемента.
- `state_description`&nbsp;— описание текущего состояния элемента. Например, для переключателя это может быть состояние `включен`/`выключен`.
- `is_checked`&nbsp;— показывает текущий статус чекбоксов, переключателей и подобных интерактивных элементов. Устанавливается в `true`, когда элемент выбран/отмечен, и в `false`, когда не выбран. Помогает accessibility-сервисам правильно озвучивать состояние пользователям.
- `mode`&nbsp;— способ организации дерева accessibility. Всего существует 3 режима:
  - `default`&nbsp;— элемент и все поддерево разбираются по отдельности;
  - `merge`&nbsp;— элемент и все его поддерево воспринимаются как единое целое;
  - `exclude`&nbsp;— элемент и все поддерево недоступно для accessibility.

## Роли элемента

- `none`&nbsp;— роль элемента отсутствует.
- `button`&nbsp;— тип кнопки. Если элемент будет иметь активные действия на одиночное или продолжительное нажатие&nbsp;— это также будет озвучено.
- `image`&nbsp;— тип изображения. Мы не сможем дать подробностей про ваше изображение, поэтому рекомендуем указать `description` для этого типа.
- `text`&nbsp;— тип текста.
- `edit_text`&nbsp;— тип поля ввода.
- `header`&nbsp;— тип заголовка.
- `list`&nbsp;— тип списка. Элементы внутри будут читаться подряд.
- `auto`&nbsp;— автоматическая простановка типа. Также является типом по умолчанию.


<!-- source: ru/_includes/index/troubleshooting.md -->
## Узнать больше {#troubleshooting}

Вы можете обсуждать интересующие вас темы в сообществе пользователей DivKit в Telegram: [https://t.me/divkit_community_ru](https://t.me/divkit_community_ru).



[Репозиторий DivKit](https://github.com/divkit/divkit)




<!-- endsource: ru/_includes/index/troubleshooting.md -->
