---
url: https://docs.juniper.bot/message-templates/components/string-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

# Меню выбора строк

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

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

![string_menu_settings_ru](string_menu_settings_ru.png)

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

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

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

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

## Варианты выбора { #options }

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

![string_menu_variants_ru](string_menu_variants_ru.png)

* **Наименование** — текст, который будет отображаться в варианте выбора;
* **Значение** — значение выбора, задаётся пользователем и не может повторяться в других вариантах выбора;
  ::: info Информация
  Именно это значение будет передано список значений выбранных участником вариантов выбора в переменной
  [`component.selectedOptions`] или в [`modal.values`] для [диалоговых окон].

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

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

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

Он также доступен для [диалоговых окон].