# Пользовательские виджеты

> [HTML Version](user_widgets.html)

Создавать и публиковать такие виджеты могут пользователи, входящие в группу [Администраторы](360006871932.md#administrators). Создавая собственный виджет, вы можете:

- разместить в его шаблоне другие системные и пользовательские виджеты, а также добавить [контекстные переменные](context_types.md) и [скрипты](client_server_scripts.md);

- включить [дополнительные опции](user-widgets-context.md#use-settings), которые управляют отображением и значением контекстных переменных при добавлении виджета на форму, страницу или в шаблон другого виджета;

- создать уникальную [форму настроек](user-widgets-context.md#settings) виджета;

- задать [системные настройки](common_widget_settings.md), которые применятся по умолчанию при размещении виджета на странице, форме или в шаблоне другого виджета;

- [настроить расположение и внешний вид виджета](designer-tabs.md#settings-tab) на форме и в дизайнере интерфейсов.

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

**(hmfile_hash_f28b6196.png)**

Подробнее об интерфейсах системы читайте в статьях [«Создание интерфейсов»](interface_settings.md) и [«Дизайнер интерфейсов»](interface_designer.md).

## Конструктор пользовательского виджета

Рассмотрим особенности настройки пользовательского виджета на примере. Допустим, на форме отчёта размещён пользовательский виджет **Аналитика**. Перейдём к его настройкам:

1. Откройте шаблон формы отчёта в дизайнере интерфейсов, выделите виджет и нажмите значок шестерёнки.  
**(user_widgets_1.png)**

В открывшемся меню доступны опции:

- **Настроить** — открыть настройки виджета, которые применятся только на текущей форме;

- **Перейти в конструктор** — открыть шаблон виджета, чтобы задать [системные настройки](common_widget_settings.md), которые применятся по умолчанию на любом элементе интерфейса, где используется виджет.

2. Выберите опцию **Перейти в конструктор**. Откроется шаблон виджета в дизайнере интерфейсов. Выделите виджет и нажмите значок шестерёнки.  
(user_widgets_2.png)

3. В открывшемся окне настроек на вкладке** Системные** в поле **HTML-стили** задайте значение **width: 100%**.  
(user_widgets_3.png)

Тогда на любой форме или странице виджет по умолчанию отобразится на всю ширину элемента, внутри которого он расположен. В нашем примере виджет **Аналитика **отобразится на всю ширину отчёта.  
(user_widgets_4.png)

4. Снова откройте шаблон формы отчёта, выделите виджет **Аналитика**, нажмите значок шестерёнки и выберите опцию [Настроить](#tune).

5. Отобразятся настройки, которые применяются только для текущей формы. Если в поле **HTML-стили** задать значение **width: 50%**, оно применится для текущей формы отчёта вместо значения **width: 100%**, заданного ранее в конструкторе виджета.  
(user_widgets_5.png)

## Виджет типа «Страница»

Для настройки [страницы ](360009924451.md)— такого же структурного элемента системы, как приложение или раздел, можно использовать виджет типа **Страница**.

Так, [настраивая](360027211631.md#setting-in-designer) страницу в дизайнере интерфейсов, вы работаете в шаблоне виджета типа **Страница**. Наполняя его другими виджетами, контекстными переменными или скриптами, вы создаёте собственный виджет типа **Страница**.

Также перейти к созданию такого виджета можно в разделе **Администрирование > Интерфейсы**. Для этого в правом верхнем углу нажмите **+ Создать** и выберите опцию **Страница**. Подробнее об этом читайте в статье [«Создание интерфейсов»](interface_settings.md#create-widget).

Готовый виджет типа **Страница** можно использовать многократно для разных страниц. Чтобы [добавить](360027211631.md#use-widget) его на новую страницу, при её создании нажмите **Добавить виджет** и выберите нужный в списке пользовательских виджетов.  
**(360027211631-5.png)**