概述

开关是一种交互组件。用户可以通过公告板数据源写入绑定，或者在集成代码的监听事件中得到更改的数据，来实现可视元件之间的协同工作。

特有属性设置

除了每个组件都拥有的常规静态属性（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;