设置UI引擎前端页面栅格布局组件属性
栅格布局组件为前端开发提供标准化、响应式的布局解决方案。采用12/24列网格系统,能够灵活适应不同屏幕尺寸,尤其适用于工业领域的监控面板、工艺流程图及数据看板等可视化界面。
通过Layout(容器)、Row(行)和Col(列)三类组件的嵌套组合,可高效构建结构清晰、排列规整的页面布局,显著提升开发效率与界面一致性。
前提条件
已在当前页面添加“栅格布局”组件,具体操作请参见为UI引擎前端页面添加物料组件。
配置入口
- 在页面设计器的中心画布区,单击选中“栅格布局”组件。
- 在右侧设置面板中,单击
,即可展开“属性”设置面板。
基础属性(Layout)
容器属性主要用于定义栅格布局的整体列数及渲染标签,是实现灵活布局的核心设置。
|
属性名称 |
说明 |
是否支持变量绑定 |
|---|---|---|
|
栅格列数选择器 |
定义每行被划分的列数,支持可选值为12或24,默认值为12列。
|
是 |
|
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”属性,用于注册模板引用以访问组件实例方法。 如果为“数据源表单”组件,会自动填充默认值。 |
是 |