更新记录

0.1.6（2026-08-18） 下载此版本

  • 蒸汽模式兼容：lines CSS 声明迁移为 <text> 的 :max-lines 属性（官方蒸汽模式方案），消除 Vapor 运行时与 CSS 编译器警告

0.1.5（2026-08-14） 下载此版本

  • 精简 readme：移除内部开发向内容（设计说明 / 实现细节 / 平台差异实现等），只保留安装、用法、API、主题等用户文档

0.1.3（2026-08-07） 下载此版本

  • 支持 iOS 端：走 #ifndef APP-ANDROID 公共注入分支，无额外端差异代码，iOS 直接可用
查看更多

平台兼容性

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 选中数组变化

主题

通过 CSS 变量覆盖：

Token 用途
--nax-color-bg 背景色
--nax-color-border-strong 强调边框色
--nax-color-primary 主题主色
--nax-color-text 主文字色
--nax-color-text-disabled 禁用文字色
--nax-color-text-inverse 反白文字色
--nax-opacity-disabled 禁用透明度

隐私、权限声明

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

无

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

无

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

无

许可协议

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

暂无用户评论。