更新记录

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

  • 修复 Android 端（APP-ANDROID）暗黑模式下原生 picker-view 上下白色渐变遮罩覆盖时间选择器面板的问题；复用鸿蒙端的 mask-top-style 与 mask-bottom-style 透明渐变方案，iOS、Web 与小程序保持原有行为。
  • 修复 Android 端（APP-ANDROID）时间滚轮选中项上下边框不显示的问题；为原生 picker-view 指示器补全 solid 边框样式并继续使用主题分割线 token，其它端保持原有行为。

平台兼容性

uni-app x(4.25)

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

其他

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

nax-datetime-picker

uni-app x 时间选择器（底部弹层 + picker-view）。

依赖

  • nax-icon（触发条箭头）
  • nax-transition（弹层进退场动画）
  • nax-ui-theme（CSS 变量 --nax-*）

基础用法

<nax-button label="选择日期时间" @click="visible = true"></nax-button>
<nax-datetime-picker
  v-model:show="visible"
  v-model="value"
  mode="datetime"
  title="选择时间"
  @confirm="onConfirm"
></nax-datetime-picker>

mode

值 列
datetime 年 月 日 时 分（+ 秒）
date 年 月 日
time 时 分（+ 秒）
year-month 年 月
year 年
month-day 月 日

常用 Props

属性 默认 说明
show false v-model:show
modelValue 0 时间戳 ms 或日期字符串
mode datetime 见上表
min-date / max-date 1950 / 当前+10年 可选范围
show-second false 显示秒列
show-unit true 列单位
format '' 自定义 formatted
show-trigger false 内置触发条
mask-closable true 点遮罩关闭
safe-area-inset-bottom true 底部安全区

事件

confirm 回调字段：value / timestamp / formatted / year / month / day / hour / minute / second / mode。

另有 update:show、update:modelValue、cancel、change、open、close。

平台说明

  • 全端原生 picker-view（含鸿蒙）。
  • 鸿蒙禁用选项点选，请滑动后确认。
  • 鸿蒙暗黑模式通过 mask-top-style / mask-bottom-style 移除原生滚轮默认的白色渐变遮罩；该分端处理由 APP-HARMONY 条件编译。
  • 微信小程序滚动中点确认会被忽略。

说明：鸿蒙 picker-view 打开时的滚到目标动画为原生行为，无法设置 duration。未传 min-date 时默认近 30 年～当前+10 年，以缩短年列滚动距离。需要更早日期请显式传 min-date。

隐私、权限声明

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

无

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

无

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

无

许可协议

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

暂无用户评论。