# 开关

开关选择器,用于开关两种状态之间的切换时,下图为开启显示开关文字的开关组件;

# 概念说明

# 单选组属性

组件通用属性请参见组件通用说明

  • 值:开关状态,返还true或者false。

  • 只读:正常显示,但禁止选择或输入。

  • 禁用:置灰显示,且禁止任何交互(焦点、点击、选择、输入等)。

    image-20230306184459196
  • 显示开关文字:设置开关是否显示开关ONOFF文字。

    image-20230301143105297

# 组件事件

  • 支持输入组件常见的事件:切换状态前,输入时,打开时,关闭时,切换状态后,改变后。
事件名 触发条件
输入前 开关输入前触发
打开时 开关打开时触发
关闭时 开关关闭时触发
切换状态后 开关切换状态后触发
改变后 开关改变后触发

# 样式

样式说明请参见组件通用说明

# 主题样式

  • 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。
上次更新: 2023年06月14日