Switch 开关
uni-appH5微信小程序App
跨端布尔开关,使用 v-model 双向绑定。
何时使用
立即生效的布尔状态切换,如通知开关、功能启用。
何时不使用
表单勾选协议/多选用 Checkbox;互斥单选用 Radio。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 绑定值,配合 v-model 使用(等价 v-model:checked) |
disabled | boolean | false | 禁用,不响应点击 |
checked | boolean | false | 开关状态,对应 v-model:checked |
loading | boolean | false | 加载中,圆点上显示旋转小圈并禁用点击 |
ariaLabel | string | "开关" | 无障碍标签(H5 端生效,App/小程序端无害透传) |
size | string:'sm' | 'md' | "md" | 尺寸:md = 44×24,sm = 34×20 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | - |
change | boolean | 状态变化时触发,携带新值;disabled/loading 时不触发 |
update:checked | boolean | 点击切换时触发,用于 v-model:checked |
示例
基础用法
vue
<Switch v-model="on" />禁用状态
vue
<view class="row">
<Switch v-model="tf1" />
<Switch v-model="tf2" />
<Switch disabled />
</view>设置项组合
vue
<CellGroup inset>
<Cell title="消息推送"><Switch v-model="tf3" /></Cell>
<Cell title="夜间模式"><Switch v-model="tf4" /></Cell>
</CellGroup>尺寸与加载
vue
<view class="row">
<Switch v-model:checked="tf1" size="sm" />
<Switch v-model:checked="tf2" size="lg" />
<Switch loading />
</view>