下拉选择组件:选项值、环境变量与数据联动
下拉选择用于让观看者选择地区、门店或设备。组件把选项值写入绑定的环境变量,后续由 API 或其他引用该变量的流程使用。
先准备变量
到项目「环境变量」创建 area 等变量。变量名需要与组件绑定一致;这里只填写一个新名称,并不会自动在项目中建立变量。
配置属性
加入「下拉选择」,在「绑定环境变量」中选择目标。再手动添加选项,分别设置显示文本与值:
| 显示文本 | 实际值 |
|---|---|
| 东区 | east |
| 西区 | west |
显示文本面向观看者;实际值应与接口参数约定一致。初始变量值与某个选项值对应时,该项可作为当前选择显示。
联动 API
将 API 地址中的 area 参数写为变量模板,再把图表绑定到该 API 数据源。选择后更新变量并请求 API 刷新。只有变量真正用于接口地址,才会产生不同的查询条件。
清空行为
组件允许清空选择,清空后写入空字符串。API 模板可通过默认值处理,例如把空选择解释为全部;具体含义还需接口支持。
测试
保存后在最终预览中依次选择和清空,核对图表与接口数据。该组件不自动构建级联选择,也不等同于图表系列的静态「等于」筛选。