Skip to content

n-checkbox-group 复选组 ​

纵向布局的复选容器,默认插槽放 n-checkbox 成员,统一接管成员的选中值集合与整组禁用。组自身不持有状态——v-model 自动回写(update:modelValue 与 change 同参同发)完成受控闭环。

  1. 值源是数组:v-model 绑定成员 name 的集合,自动回写
  2. 整组禁用与成员自身 disabled 叠加,任一生效即禁用
  3. 成员选中态、半选形态的细则看 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 成员。

记录 · 思考 · 创作