更新记录

0.1.2（2026-07-31） 下载此版本

  • 鸿蒙：遮罩与面板同帧进场，修复先闪黑再弹框

平台兼容性

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：面板自定义内容

隐私、权限声明

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

无

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

无

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

无

许可协议

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

暂无用户评论。