更新记录

0.1.2（2026-07-31） 下载此版本

  • 修复 Android 端 group 注入使用 null 默认值时被推断为 Void 的运行时崩溃：通过 APP-ANDROID 让 checkbox-group 提供普通 Ref 状态，checkbox 使用同类型默认值和明确函数兜底。其它端保持原有注入实现与行为。

平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ - √ √

其他

多语言 暗黑模式 宽屏模式
× √ ×

nax-checkbox

uni-app x 复选框 / 复选框组。

依赖

  • nax-icon（勾选图标）
  • nax-ui-theme（CSS 变量 --nax-*，安装时依赖 / 运行时弱依赖）

基础用法

单独使用

<nax-checkbox v-model="checked" label="同意协议" @change="onChange"></nax-checkbox>

复选框组

<nax-checkbox-group v-model="values" @change="onGroupChange">
  <nax-checkbox name="apple" label="苹果"></nax-checkbox>
  <nax-checkbox name="banana" label="香蕉"></nax-checkbox>
  <nax-checkbox name="orange" label="橙子"></nax-checkbox>
</nax-checkbox-group>

组内用 name / value 作为选项标识（value 优先），不要再给子项绑 v-model。

nax-checkbox Props

属性 类型 默认 说明
modelValue boolean false 单独使用时的选中态（v-model）
name string '' 组内选项标识
value string '' 组内选项标识，优先级高于 name
label string '' 右侧文案
shape string square square / circle；组内可被 group 覆盖
size string md sm / md / lg
disabled boolean false 禁用
labelDisabled boolean false 为 true 时点击文案不切换
activeColor string '' 选中色；空则 --nax-color-primary
iconSize string '' 勾选图标字号（数字字符串 px）
labelSize string '' 文案字号（数字字符串 px）
customClass string '' 根节点扩展 class

nax-checkbox Events

事件 说明
update:modelValue 单独使用时的 v-model
change 选中态变化（boolean）

nax-checkbox-group Props

属性 类型 默认 说明
modelValue string[] [] 选中标识数组（v-model）
disabled boolean false 整组禁用
shape string square 统一子项形状
size string md 统一子项尺寸
activeColor string '' 统一选中色
iconSize string '' 统一图标字号
labelSize string '' 统一文案字号
labelDisabled boolean false 统一：文案是否不可点选
max number 0 最多可选数量；0 不限制
wrap boolean false 每个选项独占一行
width string '' 子项宽度（如 50% / 120px）
customClass string '' 根节点扩展 class

nax-checkbox-group Events

事件 说明
update:modelValue v-model
change 选中数组变化

主题 Token

  • --nax-color-primary 默认选中色
  • --nax-color-border-strong 未选中边框
  • --nax-color-bg 未选中底
  • --nax-color-text / --nax-color-text-disabled 文案
  • --nax-color-text-inverse 勾选图标色
  • --nax-opacity-disabled 禁用透明度
  • --nax-radius-sm / --nax-radius-full 方/圆角

设计说明

  • 尺寸统一为 sm | md | lg（不用 rpx 数字作默认 API）
  • 默认 shape 为 square（与后续 radio 的圆形成区分）
  • 不提供 customStyle 泛样式入口，扩展用 customClass + CSS 变量
  • Android 端通过 APP-ANDROID 让 group 上下文使用明确的 Ref 与函数注入类型，避免 null 默认值被 UTS 推断为 Void。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

无

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。