Switch 开关
WebH5
开关。两种状态间切换,支持加载态与 sm/md 两种尺寸,白圆点滑动过渡。
何时使用
立即生效的布尔状态切换,如通知开关、功能启用。
何时不使用
表单勾选协议/多选用 Checkbox;互斥单选用 Radio。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
checked | boolean | false | 开关状态,对应 v-model:checked |
disabled | boolean | false | 禁用,不响应点击 |
loading | boolean | false | 加载中,圆点上显示旋转小圈并禁用点击 |
size | string:'sm' | 'md' | "md" | 尺寸:md = 44×24,sm = 34×20 |
ariaLabel | string | "undefined" | 无障碍标签(缺省取 locale 文案 switch.toggle) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:checked | boolean | 点击切换时触发,用于 v-model:checked |
change | boolean | 状态变化时触发,携带新值;disabled/loading 时不触发 |
示例
基础
示例加载中…
小尺寸、加载与禁用
示例加载中…
受控开关 + 状态回显
示例加载中…
Playground
加载中…
md
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Switch 文档(含手机预览)。