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

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

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

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

string_menu_settings_ru

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

    Информация

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

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

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

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

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

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

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

string_menu_variants_ru

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

    Информация

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

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

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

Доступность ​

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

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

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