helper.switch

Конструкция switch-case. Последовательно проверяет различные условия и выполняет код из свойства result, когда соответствующее условие оказывается истинно.

Вы можете использовать его, чтобы выполнить некое действие или отобразить дополнительный элемент интерфейса только при выполнении определенного условия.

Этот хелпер похож на ряд логических выражений If...Then...Else: его удобно использовать, если условий для последовательной проверки больше двух. Если вам нужно проверить одно-два условия, используйте компонент helper.if.

Порядок работы хелпера:

  1. Хелпер проверяет условия (conditions) из массива объектов cases, начиная с первого.
  2. Если условие истинно (возвращает true), хелпер возвращает результат (блок кода), указанный в свойстве result соответствующего условию (condition) объекта массива cases. Хелпер завершает работу и последующие условия не проверяются.
  3. Если условие ложно (возвращает false), хелпер проверяет последующее условие.
  4. Если в результате всех проверок все условия ложны, хелпер возвращает значение, указанное в свойстве default (если оно не определено, хелпер ничего не возвращает).

Компоненты, которые используются в примере
  • layout.sidebar — добавляет раздел с основными компонентами и панель управления ими;
  • view.image — показывает картинку;
  • view.list — отображает данные списком;
  • field.radio-group — добавляет группу переключателей-радиокнопок для выбора одного ответа;
  • data.output — определяет данные задания, которые вы получите после его отправки исполнителем;
  • condition.equals — проверяет, что значение равно указанному;
  • view.alert — создает цветную рамку для выделения важной информации;
  • view.markdown — отображает текст в разметке Markdown;
  • field.text — добавляет поле для ввода текста;
  • condition.required — проверяет, что поле с данными заполнено.

Свойства компонента

Название

Тип

Описание

type*

"helper.switch"

Задает тип компонента.

cases*

array

Массив объектов, состоящих из пар свойств condition и result.

cases[]

object

Параметры объекта.

cases[].condition*

condition

Условие, которое проверяется.

cases[].result*

any

Элемент, который будет возвращен, если условие из соответствующего свойства condition истинно (вернет true).

default

any

Элемент, который будет возвращен, если ни одно из проверенных условий не вернуло true.
Предыдущая
helper.search-query
Следующая
helper.text-transform