---
url: https://docs.juniper.bot/message-templates/components/entity-select-menu.md
description: >-
  В данной статье описывается компонент "Меню выбора сущностей", используемый в
  шаблонах сообщений.
---

[действие]: ../../../cmd/custom/actions/index

[действия]: ../../../cmd/custom/actions/index

[действии]: ../../../cmd/custom/actions/index

[действий]: ../../../cmd/custom/actions/index

[действиях]: ../../../cmd/custom/actions/index

[`component.id`]: ../../types/custom-commands/component

[`component.selectedOptions`]: ../../types/custom-commands/component

[`modal.values`]: ../../types/custom-commands/modal

[диалоговых окон]: ../../../cmd/custom/actions/modal-form

# Меню выбора сущностей

Меню выбора сущностей — интерактивный компонент, позволяющий выбрать доступных на сервере участников, ролей или каналов.

Настройки этого компонента представлены так:

![entity_menu_settings_ru](entity_menu_settings_ru.png)

* **Идентификатор** — идентификатор компонента (придумываете сами).
  ::: info Информация
  Идентификатор должен быть уникальным среди других компонентов.

  [Действие], запускаемое при выборе пунктов меню, получает идентификатор соответствующего меню в переменной
  [`component.id`] и список значений выбранных участником вариантов выбора в переменной [`component.selectedOptions`].

  При использовании в [диалоговых окнах](../../../cmd/custom/actions/modal-form), шаблон запускаемого диалоговым окном
  [действия] получает список значений выбранных вариантов выбора в переменную-карту [`modal.values`],
  ключом которого является данный идентификатор.

  Таким образом, в [действии] можно определить какие варианты выбора меню были выбраны.
  :::
* **Тип меню** — выбор типа сущностей, из которых будут составлены варианты выбора (участники, роли или каналы);
* **Минимальное количество элементов** — минимально допустимое количество элементов для выбора;
* **Максимальное количество элементов** — максимально допустимое количество элементов для выбора;
* **Текст-заглушка** — текст, который будет отображаться внутри меню выбора если ничего не выбрано;
* **Действие** — выбор [действия], которое будет запускаться при выборе пунктов меню;
* **Неактивный** — сделать меню выбора неактивным. Будет тусклым и на него нельзя будет нажать.

## Доступность { #availability }

Данный компонент доступен только для [действий] пользовательских команд во всех режимах отправки сообщений (текст, панель, компоненты).

Он также доступен для [диалоговых окон](../../../cmd/custom/actions/modal-form).