使用小组件 > 2D > 切换按钮
  
切换按钮
这个小组件有什么功能?
“切换按钮”小组件类似于“复选框”小组件,但允许使用资源自定义不同的状态。
何时会用到这个小组件?
当您想要允许用户使用按钮在两种状态之间切换设置时,会用到“切换按钮”小组件。例如,如果您想在体验中加入音频设置,以允许用户打开和关闭声音,则可使用“切换按钮”小组件。
这个小组件中是否有专用的属性、服务、事件或操作?
若要查看小组件常用的属性、服务和事件的列表,请参阅小组件的通用属性、服务和事件
下表列出了该小组件的专用属性。
属性
JavaScript
类型
说明
背景颜色已按下
backgroundColorPressed
string
指定按下按钮时的背景颜色。
未按下时的图像
srcnotpressed
resource url
指定未按下按钮时显示的图像。支持的文件格式包括:
.png
.jpg, .jpeg
.svg
.gif
.bmp
按下时的图像
src
resource url
指定按下按钮时的图像。支持的文件格式包括:
.png
.jpg, .jpeg
.svg
.gif
.bmp
未按下
notpressed
boolean
指定未按下按钮时发生的情况。这是一个双向可绑定的属性。
已按下
pressed
boolean
指定按下按钮时发生的情况。这是一个双向可绑定的属性。
事件
JavaScript
说明
已按下
pressed
按下时,触发此事件。
未按下
unpressed
在更改为“未按下”状态时,触发此事件。
小组件的显示效果
以下是小组件的显示效果示例!
使用时的必要步骤
显示效果
1. “切换按钮”小组件拖放到工作区。
2. “切换按钮”小组件的“已按下”“未按下”属性绑定到其他小组件或服务。在本示例中,我们将“切换按钮”“已按下”属性与包含简单工具栏的“面板”小组件绑定,然后在“选择绑定目标”窗口上选择“可见”。当按下切换按钮时,将显示或隐藏面板。