更新记录

0.4.0（2026-10-20） 下载此版本

• 新增组件 nax-form-render（0.1.0）并纳入套装依赖聚合：schema/JSON 驱动的动态表单渲染器，控件类型为封闭枚举（蒸汽模式模板编译期静态分析，分支源码内穷举），复用 nax-form + nax-form-item 的标签与校验链路（聚合组件数 53 → 54，nax-video 仍独立发布不在套装内）
• package.json description、readme 与 docs/component-inventory.md 的组件数表述同步为 54

0.3.7（2026-09-28） 下载此版本

• 套装依赖补齐：uni_modules.dependencies 增加此前遗漏的 nax-table（0.1.0，columns/data 数据驱动的数据表格），package.json description 与 readme 的组件数表述同步为 53（聚合组件数 52 → 53）
• 依赖组件更新：nax-rich-text（0.3.1→0.3.2）修复单独安装缺包——组件内使用 <nax-icon>（视频 / 音频播放钮）与 <nax-loading>（视频加载反馈），uni_modules.dependencies 此前只声明 nax-ui-theme，单独安装时这两个组件缺失（套装安装不受影响）

0.3.5（2026-09-10） 下载此版本

• 依赖组件更新：nax-textarea（0.2.5→0.2.6）修复长按滚动页面时聚焦样式残留（触摸预亮 + touchmove 位移阈值撤回，对齐 nax-input 机制）；readonly 不再点亮聚焦样式
• 依赖组件更新：nax-popup（0.3.0→0.3.1）修复 host 关闭退场期间位置残留（退场冻结最后面板位置）；小程序自定义 url 不支持 dialogPage 时不再静默降级空白面板（warn 后直接返回）；微信小程序左右抽屉胶囊避让按面板横向范围判定
• 依赖组件更新：nax-picker（0.1.4→0.1.5）修复微信小程序左右抽屉顶部安全距离判定（按面板实际宽度判断是否覆盖胶囊区域）；抽屉退场定时器丢失时根层残留兜底卸载

平台兼容性

uni-app x(4.25)

其他

nax-ui

nax-ui 是面向 uni-app x 的 UI 组件套装入口，定位为 uni-app x 蒸汽模式组件库：基于原生渲染管线的 vapor 模式（去虚拟 DOM），不承诺 VDOM 渲染模式兼容。

组件源码按独立 nax-* uni_modules 发布；本包不重复收录组件源码，而是通过 package.json 聚合当前 54 个 nax-* 组件包、nax-ui-theme（主题）与 nax-use（组合式函数）（nax-video 独立发布，不在套装内）。可以安装整套，也可以只安装需要的独立组件。

官方文档

在线文档与组件示例：https://www.nax-ui.cn/

安装方式

整套安装

安装 nax-ui。套装依赖以本包 package.json 的 uni_modules.dependencies 为准。

按需安装

只安装需要的 nax-* 组件，并按对应组件文档补充它的依赖。

支持平台

• Web
• 微信小程序
• App Android
• App iOS
• App HarmonyOS

App 端版本要求：HBuilderX 鸿蒙 5.0+ / iOS 5.11+ / Android 5.21+（需在 manifest.json 开启蒸汽模式）；系统要求 Android 6.0+ / iOS 15+ / 鸿蒙 6.0+。Web 与微信小程序不受蒸汽模式影响。

主题接入

在 App.uvue 引入主题样式：

@import "@/uni_modules/nax-ui-theme/theme/default.css";

页面或布局根节点挂载 class="nax-theme"。暗色主题使用 nax-theme-dark 修饰类，详见 uni_modules/nax-ui-theme/readme.md。

组合式函数

套装依赖聚合 nax-use 包（倒计时、防抖、节流、轮询、本地缓存、表单校验、日期时间 parts），导入方式：

import { useCountdown } from '@/uni_modules/nax-use/composables/use-countdown.uts'

详见 uni_modules/nax-use/readme.md。

使用示例

nax-ui 是套装入口，不是实际渲染组件，不需要也不能写成 <nax-ui />。安装完成后直接使用具体组件：

<nax-button type="primary" label="确定" @click="onConfirm"></nax-button>