更新记录

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

  • 精简 readme：移除内部开发向内容（设计说明 / 实现细节 / 平台差异实现等），只保留安装、用法、API、主题等用户文档

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

  • 支持 iOS 端：App 端条件编译分支（click 走 touch 路径、阴影降级）已覆盖 APP-IOS

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

  • 移除滑块数值气泡以及 showValue、valuePosition 公共 props；当前值由业务侧在滑块外使用普通文本展示。
  • 这是不兼容变更，Android、iOS、鸿蒙、Web 与小程序端统一生效；其它滑块能力保持不变。
查看更多

平台兼容性

uni-app x(4.25)

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

其他

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

nax-slider

uni-app x 滑动选择器，功能覆盖常用场景。

依赖

  • nax-ui-theme（CSS 变量 --nax-*，安装时依赖 / 运行时弱依赖）

基础用法

<nax-slider v-model="value" @change="onChange"></nax-slider>

Props

属性 类型 默认 说明
modelValue number 0 当前值（v-model），落在 [start, end]
start number 0 整体范围起点
end number 100 整体范围终点
min number 0 可选最小值（夹在 start/end 内）
max number 100 可选最大值（夹在 start/end 内）
step number 1 步长
size string md sm / md / lg，影响轨道高度与滑块尺寸
blockWidth number 0 滑块边长（px）；0 跟随 size
height number 0 轨道高度（px）；0 跟随 size
inactiveColor string '' 轨道底色；空则 --nax-color-border
activeColor string '' 已选轨道色；空则 --nax-color-primary
blockColor string '' 滑块颜色；空则 --nax-color-bg
disabled boolean false 禁用
useSlot boolean false 使用默认插槽自定义滑块
showEdgeValue boolean false 显示起止数值
edgeValuePosition string top 起止数值位置 top / bottom
customClass string '' 根节点扩展 class

Events

事件 说明
update:modelValue v-model
change 松手/点击后的最终值
start 开始滑动
moving 滑动中
end 滑动结束

Slot

名称 说明
default 自定义滑块（需 useSlot）

主题

通过 CSS 变量覆盖：

Token 用途
--nax-color-bg 背景色
--nax-color-border 边框色
--nax-color-primary 主题主色
--nax-color-text-secondary 次要文字色
--nax-opacity-disabled 禁用透明度

范围说明

  • start / end：整条轨道的刻度范围（决定滑块视觉位置）
  • min / max：可选取值区间，会被夹在 [start, end] 内
  • 小数范围请同时设置 :start / :end（例如 0–1 且 step=0.1），不要只设 min/max 而保留默认 end=100

隐私、权限声明

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

无

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

无

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

无

许可协议

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

暂无用户评论。