更新时间:2026-03-16 GMT+08:00
分享

设置UI引擎前端页面栅格布局组件属性

栅格布局组件为前端开发提供标准化、响应式的布局解决方案。采用12/24列网格系统,能够灵活适应不同屏幕尺寸,尤其适用于工业领域的监控面板、工艺流程图及数据看板等可视化界面。

通过Layout(容器)、Row(行)和Col(列)三类组件的嵌套组合,可高效构建结构清晰、排列规整的页面布局,显著提升开发效率与界面一致性。

前提条件

已在当前页面添加“栅格布局”组件,具体操作请参见为UI引擎前端页面添加物料组件

配置入口

  1. 在页面设计器的中心画布区,单击选中“栅格布局”组件。
  2. 在右侧设置面板中,单击,即可展开“属性”设置面板。

基础属性(Layout)

容器属性主要用于定义栅格布局的整体列数及渲染标签,是实现灵活布局的核心设置。

属性名称

说明

是否支持变量绑定

栅格列数选择器

定义每行被划分的列数,支持可选值为12或24,默认值为12列。

  • 12列:适用于常规设备监控面板等场景,提供均衡的布局效果。
  • 24列:适用于高精度数据报表场景(如多参数实时监控),能够实现更精细的布局控制。

layout渲染的标签

指定Layout组件根节点在HTML转换时使用的标签,默认值为“div”。可根据SEO优化或特定框架的需求,调整为更具语义化的标签(如section、article等)。

基础属性(Row)

行属性主要用于定义单行的布局方式、子项排列及间隔,支持灵活调整以满足不同场景需求。

属性名称

说明

是否支持变量绑定

列数选择器

UI引擎内置的列数快速选择器,适用于简单布局场景。

自定义: (可拖拽分隔符调整)

通过拖拽分隔符直观调整各列占比。

默认比例:3:3:3:3(12列布局下)。

flex容器

设置行组件是否为Flex容器,默认值为“false”

开启后可通过子项对齐方式和子项排序实现复杂布局。

子项对齐方式

仅当行组件开启Flex容器时有效,等效于CSS的“align-items”属性,用于控制子项的垂直对齐方式。

可选值:顶部对齐、垂直居中、底部对齐。

子项间隔

定义子项之间的水平间距(单位:px),默认值为0。

子项排序

定义子项的排序方式,需配合Col组件的排序编号使用。

可选值:升序、降序。

不设置时,保留模板中的默认顺序。

基础属性(Col)

列属性用于定义单个列的宽度、偏移量及响应式行为,是栅格布局的核心单元。

属性名称

说明

是否支持变量绑定

栅格列格数

定义该列占据的栅格数。

默认场景:12列布局下4个子项各占3格。

排序编号

指定该列在Row中的排列顺序,配合Row的子项排序属性使用。

间隔格数

定义该列的向右偏移量(通过“margin-left”实现)。

超小屏格数

屏幕宽度<768px时的栅格占用数。

适用设备:工业手持终端、小型控制面板。

小屏格数

768px≤宽度<992px时的栅格占用数。

适用设备:平板电脑、中型控制台。

中屏格数

992px≤宽度<1200px时的栅格占用数。

适用设备:标准工控机显示器。

大屏格数

1200px≤宽度<1920px时的栅格占用数。

适用设备:高清监控大屏、指挥中心屏幕。

超大屏格数

宽度≥1920px时的栅格占用数。

适用设备:超宽拼接屏、数据可视化大屏。

其他

如下属性适用于UI引擎所有组件,用于精细化控制。

属性名称

说明

是否支持变量绑定

元素id值

对应HTML标签的“id”属性,同一页面内必须唯一。

样式类

对应HTML标签的“class”属性,为空格分隔的类名列表,用于自定义组件样式。默认为“component-base-style”

ref引用类

对应Vue的“ref”属性,用于注册模板引用以访问组件实例方法。

如果为“数据源表单”组件,会自动填充默认值。

相关文档