@neosjs/slider
滑块组件。支持单滑块与双滑块(范围)模式,拖动结束后按 step 取值,悬停滑块会显示当前值的气泡提示,颜色样式均可定制。支持鼠标与触摸操作。
安装
sh
pnpm add @neosjs/slidersh
npm i @neosjs/slidersh
yarn add @neosjs/slider快速上手
单滑块模式下,value 为数值,配合 v-model:value 双向绑定。
vue
<script setup lang="ts">
import { Slider } from '@neosjs/slider'
import { ref } from 'vue'
const value = ref(30)
</script>
<template>
<Slider v-model:value="value" :min="0" :max="100" :step="1" />
</template>范围选择
range 为 true 时,value 为 [number, number] 元组,两个滑块可分别拖动,组件会自动校正起点与终点的顺序。
vue
<script setup lang="ts">
import { Slider } from '@neosjs/slider'
import { ref } from 'vue'
const rangeValue = ref<[number, number]>([20, 80])
</script>
<template>
<Slider v-model:value="rangeValue" range />
</template>TIP
数值在拖动结束时按 step 步进取整后更新;step 为小数时会按小数精度处理,避免浮点误差。
Props
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| value | number | [number, number] | 必填 | 当前值,range 模式下为起止值元组 |
| disabled | boolean | false | 是否禁用 |
| min | number | 0 | 最小值 |
| max | number | 100 | 最大值 |
| step | number | 1 | 步长,支持小数 |
| range | boolean | false | 是否为双滑块范围模式 |
| tooltip-color | string | '#2d333b' | 悬停提示气泡的背景色 |
| theme-color | string | '#1890ff' | 主题色(已选轨道与滑块描边) |
| theme-hover-color | string | '#fafafa' | 悬停时轨道颜色 |
| bar-color | string | '#f5f5f5' | 未选轨道背景色 |
| thumb-color | string | '#fff' | 滑块背景色 |
| thumb-size | number | 12 | 滑块直径(px) |
Emits
| 事件名 | 参数 | 说明 |
|---|---|---|
| update:value | (payload: number | [number, number]) | 值变化时触发,用于 v-model:value |
| onChange | (payload: number | [number, number]) | 拖动结束取值变化时触发 |