Перейти к содержанию

Компоненты сообщения

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

Интерфейс#

Кнопки#

button

Интерфейс редактирования компонента "Кнопка"

  • Идентификатор — идентификатор компонента, задаётся пользователем (придумываете сами). Должен быть уникальным среди других компонентов этого действия;

    Информация

    Шаблон запускаемого кнопкой Действия получает идентификатор нажатой кнопки в переменной component.id.

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

  • Наименование — название кнопки, которое будет отображаться;

  • Стиль — стиль кнопки. Ниже представлены примеры стилей кнопок с их названиями:
    button-style
  • Действие — выбор Действия, которое будет запускаться при нажатии на кнопку;
  • Неактивный — сделать кнопку неактивной. Будет тусклой и на неё нельзя будет нажать;
  • Добавить эмоцию — Добавляет в кнопку выбранную вами эмоцию.

Меню выбора#

select-menu

Интерфейс редактирования компонента "Меню выбора"

  • Идентификатор — идентификатор компонента, задаётся пользователем (придумываете сами). Должен быть уникальным среди других компонентов этого действия;

    Информация

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

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

  • Минимальное необходимое количество элементов для выбора — говорит само за себя, указывается минимальное количество элементов для выбора;

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

select-menu-option

Интерфейс редактирования варианта выбора
  • Наименование — текст, который будет отображаться в варианте выбора;

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

    Информация

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

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

  • Описание — описание варианта выбора;

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

Ограничения#

Ограничения

Компоненты сообщения имеют некоторые ограничения:

  1. Максимум 5 строк компонентов сообщений;

  2. Максимум 5 кнопок на одну строку;

  3. Максимум одно меню выбора в одной строке;

  4. Нельзя иметь в одной строке одновременно меню выбора и кнопки;

  5. До 25 варинтов выбора в меню.