# Строка формы

> [HTML Version](form_line_widget.html)

Виджет используется как контейнер для других элементов формы. В нём можно располагать другие виджеты. Кроме того, в виде строки формы отображаются переменные из [контекста](360028941112.md) приложения, бизнес-процесса или виджета, вынесенные на поле для моделирования. Подробнее о переменных читайте в статье [«Типы контекста в интерфейсах»](context_types.md).

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

**(form_line_widget-1.png)**

Чтобы разместить виджет, перетащите его с правой панели [дизайнера интерфейсов ](interface_designer.md)на поле для моделирования или нажмите кнопку **+ Виджет**. Подробнее читайте в статье [«Шаблон формы для приложений и процессов»](360029250931.md). Затем выполните настройку в открывшемся окне.

## Вкладка «Основные»

## (hmfile_hash_5305508d.png)

В поле** Надпись **задайте текст, который отобразится в виде заголовка виджета. Вы можете [связать](bind-field-to-widget-option.md) это поле с контекстной переменной, нажав **(360028823292-5.png)**. Тогда содержащееся в ней значение станет заголовком.

## Вкладка «События»

На этой вкладке можно настроить поведение виджета, выбрав функции из скриптов, которые будут вызываться при наступлении различных событий. **Событие при наведении курсора** и **Событие при перемещении курсора за границы** доступны для любого виджета. Подробнее читайте в статье [«Системные настройки виджетов»](common_widget_settings.md).

Для контекстных переменных, вынесенных в виде строки формы, также можно настроить:

1. **Событие при изменении значения **—** **запустится, когда пользователь начнёт редактировать значение в поле, вынесенном в виде строки формы. Например, при изменении значения в поле **Скидка** итоговая сумма заказа будет пересчитываться автоматически.

Обратите внимание, вы можете добавить служебную переменную в контекст виджета, чтобы запустить событие. Её не нужно выносить на шаблон виджета. В настройках этой переменной используйте опцию [Событие при изменении значения](context_types.md#event-change).

2. **Событие при окончании изменения значения** — произойдёт, когда пользователь закончит редактировать значение в поле, вынесенном в виде строки формы, т. е. нажмёт **Enter** или переместит курсор за пределы поля. Например, в пользовательском виджете **Калькулятор** результат вычислений будет обновляться только после полного завершения ввода новых значений.

Начиная с версии системы 2026.4 **Событие при окончании изменения значения** также выполнится, если значение поля изменилось:

- с помощью скрипта;

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

## Вкладка «Системные»

Системные настройки одинаковы для всех виджетов. Они позволяют управлять видимостью виджета, доступом к нему и т. д. Подробнее читайте в статье [«Системные настройки виджетов»](common_widget_settings.md#system).

Для завершения настройки виджета нажмите кнопку **Сохранить**. Чтобы настроенная форма стала доступна пользователям, нажмите **Сохранить** и **Опубликовать **на верхней панели дизайнера интерфейсов.

## Вкладки «События Таблицы» и «Настройки отображения»

Эти вкладки доступны в виджете **Строка формы**, если на поле для моделирования вынести контекстную переменную типа **Таблица**. С их помощью вы можете настроить:

- на вкладке **События Таблицы** — [отслеживание действий пользователя с таблицей](table-events.md): изменение ячейки, окончание её изменения, удаление и перемещение строки. К действию можно привязать выполнение скрипта. Например, когда сотрудник вручную заполняет одни ячейки таблицы, автоматически производится расчёт и добавляются значения в другие ячейки;

- на вкладке **Настройки отображения** — параметры для работы пользователей с таблицей: видимость, редактирование, обязательность заполнения, возможность удалять и добавлять строки. Подробнее читайте в статье [«Отображение таблицы на формах разного типа»](customizing-table-visibility.md#interface-designer).