跳到主要内容

Switch 开关 ​

WebH5

开关。两种状态间切换,支持加载态与 sm/md 两种尺寸,白圆点滑动过渡。

何时使用 ​

立即生效的布尔状态切换,如通知开关、功能启用。

何时不使用 ​

表单勾选协议/多选用 Checkbox;互斥单选用 Radio。

Props ​

名称类型默认值说明
checkedbooleanfalse开关状态,对应 v-model:checked
disabledbooleanfalse禁用,不响应点击
loadingbooleanfalse加载中,圆点上显示旋转小圈并禁用点击
sizestring:'sm' | 'md'"md"尺寸:md = 44×24,sm = 34×20
ariaLabelstring"undefined"无障碍标签(缺省取 locale 文案 switch.toggle)

Events ​

名称载荷说明
update:checkedboolean点击切换时触发,用于 v-model:checked
changeboolean状态变化时触发,携带新值;disabled/loading 时不触发

示例 ​

基础 ​

示例加载中…

小尺寸、加载与禁用 ​

示例加载中…

受控开关 + 状态回显 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Switch 文档(含手机预览)。