Вложенная панель

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

Общие переменные (свойства)

[?]

Общие переменные и группы переменных: Имя, Дополнительные свойства, Стиль, Свойства контейнера, Прелоадер, События, Привязки.

Ссылка

Путь к контексту инструментальной панели, соответствующей панели для загрузки и отображения внутри данного компонента.

Имя переменной:

reference

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

reference

String

Ссылка

Контекст по умолчанию

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

Имя переменной:

defaultContext

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

context

String

Контекст по умолчанию

Контент

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

Имя переменной:

content

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

content

Boolean

Контент

Конкуренция при запуске


Контролирует, загружается ли компонент подпанели одновременно с родительской панелью или ожидает загрузки после полной загрузки родительской панели. Может влиять на скорость загрузки панели, если используется много подпанелей.

Имя переменной:

startupConcurrency

Записи:

1

Формат записи:

Имя поля

Тип поля

Примечания

startupConcurrency

Boolean

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

False - Загрузка вложенных инструментальных панелей в родительскую панель, и когда родительская панель будет готова, эти вложенные панели будут отображены. Может привести к повышению производительности, если в родительской инструментальной панели находится много вложенных панелей.

Программное переключение (атомарное обновление)

При переключении сабдашбордов не используйте последовательные вызовы setVariableField() для reference и defaultContext. Последовательная установка может приводить к промежуточному состоянию и кратковременному сообщению No Data или к нестабильной отрисовке при быстром переключении.

Используйте атомарный метод:

updateSource(newReference, newDefaultContext)

Где:

  • newReference — ссылка (reference) на целевой сабдашборд;

  • newDefaultContext — контекст (context), который должен использоваться по умолчанию.

Пример (вместо нескольких setVariableField):

// Было (не рек.) — цепочка раздельных установок:
setVariableField('subdashboard1','reference','reference', null);
setVariableField('subdashboard1','reference','reference','users.admin.dashboards.subDash1');
setVariableField('subdashboard1','defaultContext','context','users.admin.dashboards.subDash1');

// Стало (рекомендовано) — один атомарный вызов:
updateSource(
'users.admin.dashboards.subDash1',
'users.admin.dashboards.subDash1'
);

Почему это важно

updateSource() применяет reference и defaultContext одновременно, исключая «окно» между сбросом старого значения и установкой нового. Это предотвращает вспышки No Data и делает переключение стабильным даже при быстром многократном нажатии.

Подсказка (low-code): привязывайте к каждой кнопке один вызов updateSource() (одна цель — один вызов). Избегайте промежуточных сбросов через null.

Общие события

[?]

Общие события: нет.

Показ

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

Event Name

shown

Records:

1

Record Format:

Field Name

Field Type

Notes

dashboard

String

Путь к контексту инструментальной панели, отображаемому компонентом вложенной панели.

Was this page helpful?