更新记录

0.2.6（2026-09-01） 下载此版本

• 修复 modelValue 被外部置 null 时崩溃（Cannot read property length of null）：useStorage 置 null 删除 key 等场景下 v-model 传入 null，innerValue 在初始化与 modelValue watch 双入口统一规整为空串，保证内部 .length 访问与原生 value 绑定安全；外部置 null 显示为空串（同清空语义），其它行为不变

0.2.5（2026-08-31） 下载此版本

• 聚焦指令位与触摸预亮状态机重构：innerFocus 真实失焦复位（不再依赖 blur 时序推断）、touchmove / touchcancel 撤回预亮（长按滚动列表不残留聚焦样式）
• 清除 / 密码可见按钮 Web 端 mousedown 阻止先失焦（#ifdef WEB 条件编译），点击按钮不清除聚焦样式；其它端行为不变

0.2.4（2026-08-27） 下载此版本

• 修复聚焦样式与实际焦点状态不同步：
  • 点击清除/密码可见按钮不再写死聚焦态：真实聚焦的输入框点击清除后保持聚焦样式（App 端点击按钮不失焦），已失焦的输入框（多输入框场景）点击清除不会被点亮
  • 根节点 touchstart 提前点亮聚焦样式，消除 App 端聚焦回调随键盘动画延迟导致的样式晚亮（约半秒）
  • 失焦样式同步清除，移除 onBlur 150ms 延迟，切换输入框时样式即时消失

平台兼容性

uni-app x(4.25)

其他

nax-input

uni-app x 单行输入框。

依赖

• nax-icon（清除 / 密码可见 / 前后缀图标）
• nax-ui-theme（CSS 变量 --nax-*，安装时依赖 / 运行时弱依赖）

基础用法

<nax-input v-model="value" border placeholder="请输入内容"></nax-input>

<!-- 仅下边框 -->
<nax-input v-model="value" border border-type="bottom" placeholder="下划线风格"></nax-input>

类型 type

传入 select / textarea / idcard 会回落为 text。

常用 Props

更多键盘相关：cursor-spacing、selection-start、selection-end、confirm-hold、adjust-position、hold-keyboard、placeholder-style。

事件

插槽

主题

通过 CSS 变量覆盖：

平台说明

• 基于原生 input，键盘类型随端能力差异以官方文档为准。
• readonly 通过禁用原生编辑实现（样式弱于 disabled）。
• Android 暗黑模式下跨组件 CSS 变量可能失效，请通过 custom-class 传入 nax-theme-dark。