百度智能云物联网可视化设组件操作指南 - 开关
文档简介：
概述：
开关是一种交互组件。用户可以通过公告板数据源写入绑定，或者在集成代码的监听事件中得到更改的数据，来实现可视元件之间的协同工作。
咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！
微信咨询
免费试用、价格特惠
概述
开关是一种交互组件。用户可以通过公告板数据源写入绑定，或者在集成代码的监听事件中得到更改的数据，来实现可视元件之间的协同工作。
特有属性设置
除了每个组件都拥有的常规静态属性（X, Y, 宽，高等属性）之外，开关主要还有如下特有配置项：
| 属性名称 | 描述 | 类型 |
|---|---|---|
| 背景样式-背景色-开 | 开关在开状态下的背景颜色 | color |
| 背景样式-背景色-关 | 开关在关状态下的背景颜色 | color |
| 背景样式-线型 | 开关背景边框的线型 | string |
| 背景样式-边框 | 开关背景边框的颜色 | color |
| 背景样式-线宽 | 开关背景边框的线宽 | number |
| 文字样式-文字-开 | 开关在开状态下的描述文字 | string |
| 文字样式-文字-关 | 开关在关状态下的描述文字 | string |
| 文字样式-字体 | 开关描述文字的字体 | string |
| 文字样式-字号 | 开关描述文字的字号 | number |
| 文字样式-颜色-开 | 开关在开状态下描述文字的颜色 | color |
| 文字样式-颜色-关 | 开关在关状态下描述文字的颜色 | color |
| 文字样式-字体样式 | 是否加粗，是否倾斜 | boolean |
| 滑块样式-当前值 | 当前开关的值 | boolean |
| 滑块样式-背景色-开 | 滑块在开状态下的背景颜色 | color |
| 滑块样式-背景色-关 | 滑块在关状态下的背景颜色 | color |
| 滑块样式-线型 | 滑块边框的线型 | string |
| 滑块样式-边框 | 滑块边框的颜色 | color |
| 滑块样式-线宽 | 滑块边框的线宽 | number |
数据绑定
数据绑定，是连接『可视化仪表盘』与『数据表』的窗口。数据绑定标签中可供选择的数据表，是已在数据标签中创建好的二维数据表。数据表的创建过程可参考 仪表盘数据表处理 及 典型实践文档。
当前值
boolean类型，【单值】绑定，可参考仪表盘数据绑定。
交互
在设计器页面，可以双击元件进入元件交互；在运行或者分享页面，可以直接与元件进行交互。通过公告板数据源写绑定或PlayerAPI监听事件，均能实现可视元件间的协同工作。详情如下：
写绑定
在文档 组件之间的协同工作 中详细说明了实现组件间协同的操作方法。在开关元件中，通过对当前值属性添加写绑定，可以达到如下效果：
PlayerAPI监听事件
交互事件的监听可以通过物可视PlayerAPI中的 onWidgetEvent API。
| 事件名称 | 描述 | 监听函数 |
|---|---|---|
| onload | 页面加载后抛出标签项当前值的初始值 | (value: boolean) => void; |
| onValueChange | 切换标签项后抛出标签项的当前值 | (value: boolean) => void; |
