更新记录

0.1.2（2026-08-01） 下载此版本

  • 修复 Android 端 inject(..., null) 将 group 注入推断为 Void，导致 RefImpl cannot be cast to java.lang.Void：通过 APP-ANDROID 让 radio-group 提供普通 Ref 状态，radio 使用同类型默认值和明确函数兜底。其它端保持原有注入实现与行为。

平台兼容性

uni-app x(4.25)

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

其他

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

nax-radio

uni-app x 单选框 / 单选框组，功能覆盖常用场景。

依赖

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

基础用法

单独使用

<nax-radio v-model="checked" label="默认选项" @change="onChange"></nax-radio>

单选框组

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

组内用 name / value 作为选项标识（value 优先），不要再给子项绑 v-model。组的 v-model 为 字符串（当前选中项），不是数组。

nax-radio Props

属性 类型 默认 说明
modelValue boolean false 单独使用时的选中态（v-model）
name string '' 组内选项标识
value string '' 组内选项标识，优先级高于 name
label string '' 右侧文案
shape string circle circle / square；组内可被 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-radio Events

事件 说明
update:modelValue 单独使用时的 v-model
change 选中态变化；组内为选项 name（string），单独为 boolean

nax-radio-group Props

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

nax-radio-group Events

事件 说明
update:modelValue v-model
change 选中值变化（string）

主题 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 为 circle（与 checkbox 默认 square 区分）
  • 支持单独布尔 v-model（传统实现依赖 group）
  • 不提供 customStyle 泛样式入口，扩展用 customClass + CSS 变量
  • Android 端通过 APP-ANDROID 让 group 上下文使用明确的 Ref 与函数注入类型，避免 null 默认值被 UTS 推断为 Void。

隐私、权限声明

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

无

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

无

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

无

许可协议

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

暂无用户评论。