# 开关
开关选择器,用于开关两种状态之间的切换时,下图为开启显示开关文字的开关组件;
# 概念说明
# 单选组属性
组件通用属性请参见组件通用说明。
值:开关状态,返还true或者false。
只读:正常显示,但禁止选择或输入。
禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。
显示开关文字:设置开关是否显示开关
ON
和OFF
文字。
# 组件事件
- 支持输入组件常见的事件:切换状态前,输入时,打开时,关闭时,切换状态后,改变后。
事件名 | 触发条件 |
---|---|
输入前 | 开关输入前触发 |
打开时 | 开关打开时触发 |
关闭时 | 开关关闭时触发 |
切换状态后 | 开关切换状态后触发 |
改变后 | 开关改变后触发 |
# 样式
样式说明请参见组件通用说明。
# 主题样式
- width:开关宽度,如 1px。默认值40px。
- height:开关高度,如 1px。默认值20px。
- button-space:开关按钮距离左侧的边距值,如 1px。默认值2px。
- button-size:开关按钮大小,如 1px。默认值16px。
- button-background:开关按钮背景色,如 #223325。默认值white。
- button-radius:开关按钮圆角,如 1px。border-radius包含4个值,按顺序是上圆角、右圆角、下圆角、左圆角,数值个数可以是1至4个。1个表示所有圆角值都相等,2个表示上下同一个值左右同一个值,3个表示左右同一个值。默认值100px。这里要使按钮变成圆形,可以设置一个比较大的圆角值。
- background:开关背景色(关状态),如 #223325。默认值#ccc。
- background-checked:开关背景色(开状态),如 #223325。默认值#337EFF。
- background-disabled:开关背景色(禁用状态),如 #223325。默认值#e5e5e5。
- color:开关按钮文字颜色,如 #223325。默认值white。
- text-margin:开关按钮文字外边距,如 1px。默认值0 5px。
- transition:开关背景色渐变动画快慢参数,如 background。
- button-transition:开关按钮移动动画快慢参数,如 all 2s。