更新记录

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）修复微信小程序左右抽屉顶部安全距离判定（按面板实际宽度判断是否覆盖胶囊区域）；抽屉退场定时器丢失时根层残留兜底卸载

0.3.4（2026-09-08） 下载此版本

• 依赖组件更新：nax-popup（0.2.5→0.3.0）新增头部区域与 showHeader / showClose prop（默认 true）：标题左对齐 + 右上角「✕」关闭，命令式 openNaxPopup() options 同步支持；showClose=false 时底部保留「关闭」按钮兜底；面板 flex: 1 支持定高面板内插槽滚动
• 依赖组件更新：nax-date-strip（0.2.0→0.2.1）修复 Android 端按压反馈闪烁（hover 态改 opacity，不还原选中底色）

0.3.3（2026-09-07） 下载此版本

• 依赖组件更新：nax-search（0.2.4→0.3.0）新增 right 插槽（最右侧自定义区，如相机/扫码入口），不受 showAction / animation 影响
• 依赖组件更新：nax-date-strip（0.1.0→0.2.0）新增 selected-color / today-color / middle-color 颜色 props（内联字面量，全端生效）+ App 暗黑主题 nax-theme-dark 修饰适配

平台兼容性

uni-app x(4.25)

其他

nax-ui

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

组件源码按独立 nax-* uni_modules 发布；本包不重复收录组件源码，而是通过 package.json 聚合当前 52 个 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>