n-checkbox-group 复选组
纵向布局的复选容器,默认插槽放 n-checkbox 成员,统一接管成员的选中值集合与整组禁用。组自身不持有状态——v-model 自动回写(update:modelValue 与 change 同参同发)完成受控闭环。
- 值源是数组:
v-model绑定成员 name 的集合,自动回写- 整组禁用与成员自身
disabled叠加,任一生效即禁用- 成员选中态、半选形态的细则看 n-checkbox 文档
平台兼容性
| App | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 头条小程序 | QQ小程序 |
|---|---|---|---|---|---|---|
| √ | √ | √ | × | × | × | × |
API
属性
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| model-value | 当前选中的值集合(成员 name 的数组);数组内的值对应的成员呈选中态 | Array<String> | [] | - |
| disabled | 整组禁用:所有成员点击被拦截(保色相降透明),叠加成员自身的 disabled | Boolean | false | - |
| custom-class | 挂到根节点的额外 class(类需定义在组件样式表内) | String | "" | - |
| custom-style | 根节点行内样式,如 "flex-direction:row" 横排 | String | "" | 与 css 相同 |
事件
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| update:model-value | 最新选中值数组;与 change 同参同发,v-model 即此通道(自动回写) |
最新选中值数组(String[]) |
| change | 成员被点击后触发 | 最新选中值数组(成员 name 的集合,按点击顺序增删) |
插槽
默认插槽放 n-checkbox 成员。