Low-code дизайнер > Создание интерфейсов / Типы контекста

Типы контекста

При настройке интерфейсов и написании сценариев используются контекстные переменные. Переменные нужны, чтобы задать в виджете определённое значение, например, значение счётчика, а также настроить отображение компонентов страницы, разместить на форме необходимые для работы поля и т. д.

Следует разделять контекст виджета и контекст приложения.

Контекст виджета

Контекст виджета — это служебные переменные, которые используются для настройки виджета. Они нужны для написания сценариев, определяющих поведение виджета, а также для получения информации из приложений, загрузки файлов и т. д.

Добавить такую переменную можно в дизайнере интерфейсов на вкладке Контекст.

context-types-1

Нажмите кнопку +Добавить и создайте переменную нужного типа. Подробнее про доступные переменные читайте в статье «Типы данных в системе».

В названии переменных нельзя использовать кириллицу. Также постарайтесь использовать понятные названия, которые отражают суть переменной, например, Username вместо Var123.

Обратите внимание, в настройках переменных, кроме типа Событие, доступны опции:

  • Отображается при выполнении условия — укажите условия, при которых поле, вынесенное на вкладку Шаблон, отобразится в виджете. Таким образом вы можете настроить виджет, который подстраивается под действия пользователя. Например, если сотрудник установил переключатель Да/Нет в положение Да, то рядом появится дополнительное поле;
  • Событие при изменении значения — добавьте функцию, которая запустится, если изменится значение переменной. Например, при увеличении скидки автоматически выполнится перерасчёт суммы заказа. Опция позволяет использовать переменную в качестве служебной, например, для промежуточных расчётов. Такую переменную не нужно выносить на вкладку Шаблон.

vidget-options-1

Переменные, добавленные на вкладке Контекст, также отображаются в правой панели дизайнера на вкладке Свойства. При этом можно раскрыть и использовать список вложенных полей для свойств типа Приложение и Пользователь с подтипом Один. Кроме того, на этой вкладке размещаются системные переменные виджета.

context-types-3

В контексте пользовательского виджета находятся дополнительные опции, которые позволяют гибко настроить виджет. Вы можете указать, какие переменные являются входными и выходными, а также изменить окно настроек виджета. Подробнее об этом читайте в статье «Опции в контексте пользовательского виджета».

Пример использования переменных виджета

Допустим, вы хотите разместить на странице колонку с инструкциями по оформлению платежа, которая будет отображаться только при определённых условиях: когда менеджер по продажам, оформляя заказ, укажет способ оплаты Постоплата.

Для этого в дизайнере интерфейсов на вкладке Контекст создайте переменную типа Выбор «да/нет». Эта переменная позволяет пользователю выбирать один из двух предложенных вариантов, при этом вместо Да и Нет вы можете указать любые опции, в нашем случае, Предоплата и Постоплата.

context-types-4

Затем перейдите на вкладку Шаблон и разместите эту переменную на странице, чтобы пользователь во время работы мог выбрать один из вариантов оплаты.

Разместите на странице виджет Колонка. В окне настроек виджета в поле Скрыть нажмите на значок bind_table-icon, затем на ссылку <Не установлено> и выберите добавленную ранее переменную Способ оплаты. Опубликуйте изменения.

Теперь, если пользователь выберет вариант Постоплата в добавленном свойстве, на странице отобразится скрытая колонка с дальнейшими инструкциями по оформлению заказа.

Эту переменную можно также использовать в сценарии, к примеру, в Cобытии при наведении курсора виджета Кнопка. Тогда вкладка появится в тот момент, когда пользователь наведёт курсор на кнопку. Подробнее об этом читайте в статье «Сценарии в виджетах».

Контекст приложения

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

Со свойствами приложения можно работать в дизайнере интерфейсов, а также в стандартном режиме и расширенном режиме.

В дизайнере интерфейсов свойства приложения перечислены на правой панели на вкладке Свойства. Оттуда вы можете перетаскивать их на форму и размещать в нужном порядке.

1.67

Подробнее о свойствах форм вы можете прочитать в статье «Вкладка «Контекст».

Работа с дизайнером интерфейсов при создании шаблона формы подробно описана в статье «Шаблон формы».