更新记录

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

  • 修复微信小程序左右抽屉顶部安全距离判定：胶囊避让不再只看 position == 'right'，改为按面板实际横向范围（width 空值按默认 78% 屏宽、纯数字按 px、百分比按屏宽折算）判断是否覆盖胶囊区域——左抽屉宽度过半、右抽屉覆盖时均预留到胶囊下沿
  • 修复抽屉退场根层残留：show 置 false 收起流程被打断/重复触发导致 leaveTimer 丢失时，全屏根层会残留并挡住页面点击，退场入口兜底立即卸载（正常退场中 leaveTimer 在跑，不受影响）；仅 App 鸿蒙外的端需要该兜底（#ifndef APP-HARMONY）

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

  • readme 统一主题小节：通过 CSS 变量覆盖表格（button 风格），补充组件可覆盖的主题 Token

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

  • 支持 iOS 端：App 端能力分支已覆盖 APP-IOS，iOS 直接可用
查看更多

平台兼容性

uni-app x(4.25)

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

其他

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

nax-picker

通用弹出容器，用于自定义弹层内容。支持从 底部 / 中间 / 左侧 / 右侧 弹出。

安装

放入 uni_modules/nax-picker，依赖：

  • nax-transition
  • nax-ui-theme（可选，主题 token）

easycom 自动注册，页面内直接使用 <nax-picker>。

基础用法

<nax-button label="打开" @click="show = true"></nax-button>
<nax-picker v-model:show="show" position="bottom">
  <view class="panel">
    <text>自定义内容</text>
  </view>
</nax-picker>

弹出位置

position 说明 动画
bottom 底部面板（默认） slide-up
center 居中弹层（默认约 86% 屏宽） zoom
left 左侧抽屉（贴边全高，默认约 78% 屏宽） slide-left
right 右侧抽屉（贴边全高，默认约 78% 屏宽） slide-right

Props

属性 类型 默认 说明
show boolean false v-model:show 显隐
position string bottom bottom / center / left / right
round boolean true 圆角
mask boolean true 遮罩
maskClosable boolean true 点遮罩关闭
zIndex number 10070 层级
duration number 280 动画 ms
width string '' 宽度（居中默认约 86% 屏宽；左右抽屉默认约 78%）
height string '' 高度（左右抽屉默认全屏高）
safeAreaInsetBottom boolean true 底部安全区（仅 bottom）
customClass string '' 根 class
customStyle string '' 根 style

兼容：closeOnMask / closeOnClickOverlay 与 maskClosable 同时为 true 才可点遮罩关闭。

事件

事件 说明
update:show 显隐变更
open 打开开始
opened 打开动画结束
close 关闭完成
click-mask 点击遮罩

插槽

  • default：面板自定义内容

主题

通过 CSS 变量覆盖：

Token 用途
--nax-color-bg 背景色
--nax-color-mask 遮罩色

隐私、权限声明

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

无

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

无

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

无

许可协议

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

暂无用户评论。