# Switch 开关

表示两种相互对立的状态间的切换,多用于触发「开/关」。

# 采用对象方式渲染

基本用法

显示代码

禁用

显示代码

文字描述、自定义颜色和宽度

显示代码

支持一些方法:toggleStatus、on、off、enabled、disabled

显示代码

# 采用comp方式渲染

基本用法

显示代码

禁用

显示代码

文字描述、自定义颜色

显示代码

# 参数列表

参数 说明 类型 默认值
elObj 被渲染的元素DOM(必填) 可传入一个 DOM 对象或字符串;
若传入字符串,则会将其作为参数传入
document.querySelector以获取到对应 DOM 节点
若传入字符串,则会将其作为参数传入 document.querySelector以获取到对应 DOM 节点
-
options name switch 对应的 name 属性(name值可用于form提交,选填项) string -
on 是否为打开状态(选填项) boolean true
disabled 是否禁用(选填项) boolean false
width switch 的宽度(像素)(选填项) number(最小值:30) 40
activeText switch 打开时的描述文字(选填项) string -
inactiveText switch 关闭时的描述文字(选填项) string -
activeValue switch 打开时的值(选填项) boolean / string / number true
inactiveValue switch 关闭时的值(选填项) boolean / string / number false
activeColor switch 打开时的背景色(选填项) string(HEX值,从"#000000"至"#ffffff") -
inactiveColor switch 关闭时的背景色(选填项) string(HEX值,从"#000000"至"#ffffff") -

# 方法列表(以对象方式渲染时)

方法 说明 参数
enabled 启用switch -
disabled 禁用switch -
toggleStatus 切换打开/关闭状态 -
on 设置switch为打开状态 -
off 设置switch为关闭状态 -
destory 销毁元素 -