跳到主要内容

Checkbox 多选框 ​

WebH5

复选框。支持选中、半选(indeterminate)与禁用态,标签文本可用默认插槽覆盖。

何时使用 ​

多项选择、协议勾选、全选/半选层级选择。

何时不使用 ​

单选场景用 Radio;开关状态切换用 Switch。

Props ​

名称类型默认值说明
checkedbooleanfalse选中状态,对应 v-model:checked
labelstring""标签文本;默认插槽存在时被覆盖
disabledbooleanfalse禁用,不响应点击
indeterminatebooleanfalse半选状态(横杠),视觉上优先于 checked,常用于全选父项

Events ​

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

Slots ​

名称说明
default标签内容,覆盖 label 文本

示例 ​

基础 ​

示例加载中…

协议勾选 ​

示例加载中…

半选与禁用 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

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