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

# Всплывающие подсказки (тултипы)

В DivKit нет единого шаблона для всплывающих подсказок, но есть механизм, позволяющий показать любую верстку как всплывающую подсказку.

{% cut "Посмотреть интерактивный пример" %}

<iframe src="https://yastatic.net/s3/home/divkit/docs/1.0.8/index.html?url=https://yastatic.net/s3/home/divkit/doc_samples/common/tooltips_1.json" width="700" height="500" frameborder="1"></iframe>

{% endcut %}

## Объявление

Для объявления тултипа у нужного дива необходимо объявить массив `tooltips`.

* `id`&nbsp;— идентификатор тултипа, нужен для управления им. Обязательное поле.
* `duration`&nbsp;— время показа тултипа в мс. Если равно `0`&nbsp;— будет показываться до вызова экшена закрытия.
* `gravity`&nbsp;— положение тултипа относительно вью, внутри которой объявлен.
* `transition_in`&nbsp;— анимация, с которой появляется тултип. По умолчанию&nbsp;— сдвиг сверху вниз на 10 dp.
* `transition_out`&nbsp;— анимация, с которой скрывается тултип. По умолчанию&nbsp;— сдвиг снизу вверх на 10 dp.
* `div`&nbsp;— верстка любого дива, который будет показан в качестве тултипа.
* `offset`&nbsp;— сдвиг относительно вью, внутри которой объявлен. Является объектом, внутри которого можно объявить `x` и `y` сдвига и их единицы измерения.
* `close_by_tap_outside`&nbsp;— bool значение, позволяющее закрывать тултип при нажатии за его пределами. По умолчанию `true`.
* `tap_outside_actions`&nbsp;— массив действий, выполняемых при нажатии за пределами тултипа.
* `is_modal`&nbsp;— bool значение, определяющее модальность тултипа. Если `true`, тултип будет перехватывать системные жесты (например, жест "Назад" на Android). По умолчанию `false`.

{% cut "Пример объекта `offset`" %}

```json
"offset": {
  "x": {
    "value": 40,
    "unit": "px"
  },
  "y": {
    "value": 40,
    "unit": "px"
  }
}
```

{% endcut %}

{% cut "Пример тултипа с настройками нажатия за пределами" %}

```json
"tooltips": [{
  "id": "example_tooltip",
  "div": {
    "type": "text",
    "text": "Это тултип, который не закроется при нажатии за пределами"
  },
  "position": "bottom",
  "close_by_tap_outside": false,
  "tap_outside_actions": [{
    "log_id": "tap_outside_tooltip",
    "url": "div-action://log?message=Нажатие за пределами тултипа"
  }]
}]
```

{% endcut %}

## Управление

* `div-action://show_tooltip?id=<tooltip_id>`&nbsp;— показ тултипа.
* `div-action://hide_tooltip?id=<tooltip_id>`&nbsp;— скрытие тултипа.

Можно вызвать из любого элемента верстки. `id`&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 -->