第三章 字段与绑定
这一章解决三个问题:字段叫什么、能不能重复、改了会怎样。
1. 字段是什么
字段(bindKey)是页面和设备之间的暗号。
- 页面上的开关叫
light - 设备收到
light:1就知道“开灯” - 设备发
light:1回来,页面上的开关就显示“开”
一个字段只对应一件事。不要把“温度”和“湿度”塞进同一个字段。
2. 在哪里改
选中组件后,在右侧面板找到「数据」或「字段」区域,就能看到字段名,直接改。
有的组件有多个字段(比如电量有“电量”和“是否充电”),各改各的。
3. 起名规则
| 规则 | 正确 | 错误 |
|---|---|---|
| 小写字母、数字、下划线 | light、temp1、pump_a | 灯光、temp-1 |
| 不使用空格 | living_room | living room |
| 同一页面内唯一 | switch1、switch2 | 两个都叫 switch |
| 简短、看得懂 | temp | woshiwendu1 |
不用追求“专业”,能让设备端一眼看懂就行。
4. 重复会怎样
同一页面出现两个同名字段时:
- 你动其中一个,另一个也可能跟着变
- 设备收到一个值,不知道该给谁
- 图表、历史数据会混在一起
复制组件时最容易出现这个问题:复制出来的组件会带着原来的字段名,记得改掉。
如果两个组件本来就是同一个东西的两种显示(比如数值和仪表都显示温度),可以共用一个字段——前提是你清楚这是故意的。
5. 改了字段会怎样
| 改动 | 影响 |
|---|---|
| 只改标题、颜色 | 不影响设备 |
| 改字段名 | 设备代码、AI 生成的固件、图表配置都要跟着改 |
| 删掉组件 | 设备再发这个字段就没人接;历史数据还在 |
| 换组件类型但字段名不变 | 设备基本不用改,页面显示方式变了 |
所以:字段名定下来之后尽量别改。确实要改,就把它当成“删旧的 + 加新的”。
6. 方向和范围
- 方向(页面发设备 / 设备发页面 / 双向)一般跟着组件类型走,不用手改
- 范围(最小值、最大值、小数位)决定设备发来的值怎么显示
- 比如滑块设
0~100,设备发50就显示一半 - 设了范围但设备发超出的值,页面会按边界显示,不会报错
- 比如滑块设
7. 改完检查一遍
- [ ] 每个字段都有名字,没有空的
- [ ] 没有两个组件用同一个字段(除非故意)
- [ ] 字段名只用小写字母、数字、下划线
- [ ] 范围设置和实际设备输出一致(比如温度是
-40~80)
