Перейти к содержимому

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

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

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

string_menu_settings_ru

  • Идентификатор — идентификатор компонента (придумываете сами);

    Информация

    Идентификатор должен быть уникальным среди других компонентов.

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

    При использовании в диалоговых окнах, шаблон запускаемого диалоговым окном действия получает список значений выбранных вариантов выбора в переменную-карту modal.values, ключом которого является данный идентификатор.

    Таким образом, в действии можно определить какие варианты выбора меню были выбраны.

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

Варианты выбора

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

string_menu_variants_ru

  • Наименование — текст, который будет отображаться в варианте выбора;
  • Значение — значение выбора, задаётся пользователем и не может повторяться в других вариантах выбора;

    Информация

    Именно это значение будет передано список значений выбранных участником вариантов выбора в переменной component.selectedOptions или в modal.values для диалоговых окон.

    Таким образом, в Действии можно определить какие варианты выбора были выбраны.

  • Описание — описание варианта выбора;
  • Выбран по-умолчанию — Будет выбран изначально вместо текста-заглушки;
  • Добавить эмоцию — Добавляет в вариант выбора выбранную вами эмоцию.

Доступность

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

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

Все права зафырканы.