Checkbox 多选框
WebH5
复选框。支持选中、半选(indeterminate)与禁用态,标签文本可用默认插槽覆盖。
何时使用
多项选择、协议勾选、全选/半选层级选择。
何时不使用
单选场景用 Radio;开关状态切换用 Switch。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
checked | boolean | false | 选中状态,对应 v-model:checked |
label | string | "" | 标签文本;默认插槽存在时被覆盖 |
disabled | boolean | false | 禁用,不响应点击 |
indeterminate | boolean | false | 半选状态(横杠),视觉上优先于 checked,常用于全选父项 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:checked | boolean | 点击切换时触发,用于 v-model:checked |
change | boolean | 选中状态变化时触发,携带新值;disabled 时不触发 |
Slots
| 名称 | 说明 |
|---|---|
default | 标签内容,覆盖 label 文本 |
示例
基础
示例加载中…
协议勾选
示例加载中…
半选与禁用
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Checkbox 文档(含手机预览)。