# Типы контекста в интерфейсах

> [HTML Version](context_types.html)

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

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

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

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

Добавить такую переменную можно в [дизайнере интерфейсов](interface_designer.md):

- на вкладке **Контекст**;  
**(context-types-1.png)**

- в окне настроек виджета при [установке связи с контекстной переменной](bind-field-to-widget-option.md).

### Добавить переменную в контекст

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

Когда создаёте переменную:

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

2. Для всех переменных, кроме типа **Событие**, можно включить дополнительные опции:

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

- **Событие при изменении значения** — добавьте [функцию](client_server_scripts.md), которая запустится, если изменится значение переменной. Например, при увеличении скидки автоматически выполнится перерасчёт суммы заказа. Опция позволяет использовать переменную в качестве служебной, например, для промежуточных расчётов. Такую переменную не нужно выносить на вкладку **Шаблон**.

**(vidget-options-1.png)**

### Действия с переменной на вкладке «Контекст»

Вы можете выбрать переменную, а затем применить к ней доступные действия:

- отредактировать — нажмите название и измените его;

- удалить — удалить переменную можно, если она не используется в [шаблоне формы или виджета](360029250931.md#add_property);

- восстановить удалённую переменную. Для этого включите опцию **Показывать удалённые переменные**, выберите нужную строку в появившемся списке и нажмите **Восстановить**. Также из этого списка переменную можно удалить окончательно без возможности восстановления.

**(context-types-2.png)**

В контексте [пользовательского виджета](user_widgets.md) находятся дополнительные опции, которые позволяют гибко настроить виджет. Вы можете указать, какие переменные являются входными и выходными, а также изменить окно настроек виджета. Подробнее об этом читайте в статье [«Опции в контексте пользовательского виджета»](user-widgets-context.md).

### Использовать контекстные переменные на вкладке «Шаблон»

Переменные, добавленные на вкладке **Контекст**, отображаются в правой панели дизайнера на вкладке **Свойства**. Вы можете вынести их на [шаблон виджета](360029250931.md#add_property). При этом для свойств типа **Приложение** и **Пользователи** с подтипом **Один **доступны вложенные поля. Кроме того, на этой вкладке размещаются [системные переменные](common_widget_settings.md) виджета.

**(context-types-3.png)**

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

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

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

**(context-types-4.png)**

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

Разместите на странице виджет [Колонка](columns.md#column). В окне настроек виджета в поле **Скрыть** нажмите на значок (bind_table-icon.png), затем на ссылку **<Не установлено>** и выберите добавленную ранее переменную **Способ оплаты**. Опубликуйте изменения.

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

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

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

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

Со свойствами приложения можно работать в [дизайнере интерфейсов](360029250931.md), а также в [стандартном режиме](360009918011.md) и [расширенном режиме](360028941032.md).

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

**(1.67.PNG)**

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

Работа с дизайнером интерфейсов при создании шаблона формы подробно описана в статье [«Шаблон формы для приложений и процессов»](360029250931.md).