装饰与变量控件

最后更新: 2026/9/29

装饰块的边框、分区、容器与 14 种动效边框，以及变量控件的类型、绑定变量与选项来源说明。

概述

装饰块不承载数据，用于分区、包边、氛围动效，以及用容器把一组组件做成页签或轮播。变量控件是给看屏的人用的筛选器：它把选择的值写进页面变量，绑定同一个变量的组件、数据集参数和联动跟着变化。

功能入口

装饰：左栏「资源库」>「基础组件」的「装饰分区」（分区边框、面板外框、横幅容器、重点框选、分组容器、标签页容器、轮播容器）与「动效边框」分组。
控件：「变量控件」分组，预设有分段切换、下拉选择、布尔开关、时间轴播放。
属性：选中组件 > 右栏「组件」>「内容设置」。

操作步骤

做一个标签页容器

把要分页展示的组件分别编组（选中一批组件，Ctrl / Cmd + G），每组是一个「页签」的内容。
拖入「装饰分区」的「标签页容器」，在「内容设置」>「动效与容器」的「容器项」里每行填一个页签名，例如 全域总览、风险告警、值守联动。
在「受控分组 ID」里每行填一个编组的 groupId，顺序与「容器项」一一对应。
用「当前项索引」指定默认显示第几项。运行时只显示当前项对应编组里的组件。

做一个筛选控件

先在左栏「数据集」>「页面变量」新建变量，见数据接入。没有变量时，控件的「绑定变量」下拉为空，面板会给出「新建页面变量」的入口。
拖入「分段切换」，在「内容设置」>「绑定与类型」的「绑定变量」选该变量。
在「选项」把「选项来源」设为「手工」，「选项列表」每行一项，写成 全部: all、今日: 1。
让其他组件引用该变量：组件的「变量过滤」，或数据集参数（见数据接入）。

属性/参数说明

装饰块

属性	说明	取值/默认值
标题、副标题、徽标文字	装饰上的文案，可绑定数据	文本
样式	装饰类型	边框、分区、面板、分组容器、标签页容器、轮播容器、动效边框
标题对齐	文案对齐	左对齐、居中、右对齐
边框样式	仅「动效边框」样式可选	科技角框、双层边框、电路纹边框、六边角标、侧翼光条、雷达扫描、旋转光环、流光弧线、流向箭头、脉冲分割线、点阵装饰、菱形题头、全屏指挥舱框架、呼吸状态灯
扫描线动效	装饰上的扫描线	开启/关闭
容器摘要	容器的说明文字	文本
容器项	页签或轮播项名称	每行一项
受控分组 ID	每个容器项对应的编组 ID	每行一个，与容器项顺序对应
当前项索引	默认显示的容器项	数值
轮播间隔 (s)、自动轮播	轮播容器的自动切换	「轮播容器」预设默认开启、5 秒
线条色、角标色、标题色、副标题色、边框色、辉光色、背景色	配色	颜色
内边距、圆角	样式与布局	数值

说明：「全屏指挥舱框架」只能在已有装饰的「边框样式」下拉里选用，「动效边框」分组的预设没有它。

变量控件

属性	说明	取值/默认值
控件标题、说明文案	控件头部文字	文本
绑定变量	控件读写的页面变量	从已有变量选择
控件类型	交互形态	分段、下拉、开关、时间轴
占位文案	下拉未选时的提示	文本
重置按钮	是否显示重置	显示/隐藏
开启文案、关闭文案	开关的两侧文案；开关建议绑定布尔变量	文本
选项来源	选项从哪来	手工、数据集、表达式
选项列表	手工来源，每行一项	`全部: all`、`今日: 1`
数据集、标签字段、值字段	数据集来源，标签列做显示，值列写入变量	选择字段
表达式、标签字段、值字段、缺省值	表达式来源，例如 `dataset('options').rows()`	缺省值为 JSON，例如 `[]`
强调色、标题色、文本色、背景色、边框色、辉光色	配色	颜色

示例

「按院区筛选」：数据集 院区 含 label（院区名）、value（院区编码）。新建页面变量 campus，拖入「下拉选择」，「绑定变量」选 campus，「选项来源」选「数据集」，「数据集」选 院区，「标签字段」选 label，「值字段」选 value，打开「重置按钮」。再让表格的「变量过滤」用「数据字段」campus_code 等于变量 campus：看屏的人在下拉里选择院区，表格只显示该院区，清空后显示全部。

注意事项

注意：控件写入的是变量的运行期取值，不改变量本身的定义。

注意：自检的「大屏边界」把变量控件计为轻交互入口，建议不超过 3 个、最多 4 个，见自检与快捷键。

提示：装饰块同样可以设置入场与强调动画，见通用属性、动画与批量操作。