Skip to content

Latest commit

 

History

History
93 lines (70 loc) · 3.53 KB

gui_HtmlBoxLayout.adoc

File metadata and controls

93 lines (70 loc) · 3.53 KB
Raw
HtmlBoxLayout

HtmlBoxLayout позволяет определять расположение компонентов в HTML-шаблоне, который включается в тему.

Tip

Не используйте HtmlBoxLayout для отображения динамического содержимого или для встраивания кода JavaScript. Для этих целей лучше использовать компонент BrowserFrame.

XML-имя компонента: htmlBox.

Ниже приведен пример использования htmlBox в простом экране.

gui htmlBox 1

XML-дескриптор экрана:

link:../../../../../../source/gui_vcl/htmlBox_1.xml[role=include]

Атрибуты htmlBox:

  • Атрибут template задает имя HTML-файла, находящегося в подкаталоге layouts темы. Перед созданием шаблона необходимо создать расширение темы или новую тему.

    Например, если вы используете тему Halo и хотите назвать шаблон my_template, укажите my_template в атрибуте и разместите шаблон в файле modules/web/themes/halo/layouts/my_template.html.

    Содержимое шаблона modules/web/themes/halo/layouts/sample.html:

    link:../../../../../../source/gui_vcl/htmlBox_2.html[role=include]

    Шаблон должен содержать элементы <div> с атрибутами location. В этих элементах будут отображаться компоненты CUBA, определенные в XML дескрипторе с соответствующими идентификаторами.

    Содержимое файла modules/web/themes/halo/com.company.application/halo-ext.scss (в разделе [web_theme_extension] приведена информация о том как создать этот файл):

    link:../../../../../../source/gui_vcl/htmlBox_3.scss[role=include]

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

    Пример использования атрибута:

    link:../../../../../../source/gui_vcl/htmlBox_4.xml[role=include]