更新记录

0.1.14（2026-08-01） 下载此版本

• 修复 Android 端（APP-ANDROID）判断多列数据时将 UTSJSONObject 强转为 UTSArray 引发的 ClassCastException；改用 Array.isArray() 做运行时类型判断，其它端保持原有逻辑。
• 修复 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)

其他

nax-select

uni-app x 列选择器（底部弹层 + picker-view），功能覆盖常用场景。

依赖

• nax-icon（触发条箭头）
• nax-transition（弹层进退场动画）
• nax-ui-theme（CSS 变量 --nax-*，安装时依赖 / 运行时弱依赖）

组件特性

基础用法

<nax-button label="打开选择" @click="visible = true"></nax-button>
<nax-select
  v-model:show="visible"
  :list="list"
  title="请选择"
  @confirm="onConfirm"
></nax-select>

const visible = ref(false)
const list = [
  { value: '1', label: '雪月夜' },
  { value: '2', label: '冷夜雨' }
]

function onConfirm(items: UTSJSONObject[]) {
  // items[i].value / .label / .index
}

内置触发条

<nax-select
  v-model:show="visible"
  show-trigger
  placeholder="请选择城市"
  :list="list"
  @confirm="onConfirm"
></nax-select>

模式 mode

兼容：mutil-column / mutil-column-auto / cascade。

常用 Props

事件

确认项字段：value、label、index，若源数据有 extra 则带回。

插槽

主题 Token

平台说明

• 全端统一使用原生 picker-view 滚轮（含鸿蒙）。
• 鸿蒙：原生滚轮；已禁用选项点选（点击被吞掉），请滑动选择后点「确认」。
• 鸿蒙暗黑模式：通过 mask-top-style / mask-bottom-style 移除原生滚轮默认的白色渐变遮罩；该分端处理由 APP-HARMONY 条件编译。
• 微信小程序滚动未结束时点确认会被忽略（滚动结束后方可确认）。
• 弹层自包含，不依赖 nax-popup。
• 联动最多 4 列。