Skip to content

@neosjs/slider ​

滑块组件。支持单滑块与双滑块(范围)模式,拖动结束后按 step 取值,悬停滑块会显示当前值的气泡提示,颜色样式均可定制。支持鼠标与触摸操作。

安装 ​

sh
pnpm add @neosjs/slider
sh
npm i @neosjs/slider
sh
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 ​

参数类型默认值说明
valuenumber | [number, number]必填当前值,range 模式下为起止值元组
disabledbooleanfalse是否禁用
minnumber0最小值
maxnumber100最大值
stepnumber1步长,支持小数
rangebooleanfalse是否为双滑块范围模式
tooltip-colorstring'#2d333b'悬停提示气泡的背景色
theme-colorstring'#1890ff'主题色(已选轨道与滑块描边)
theme-hover-colorstring'#fafafa'悬停时轨道颜色
bar-colorstring'#f5f5f5'未选轨道背景色
thumb-colorstring'#fff'滑块背景色
thumb-sizenumber12滑块直径(px)

Emits ​

事件名参数说明
update:value(payload: number | [number, number])值变化时触发,用于 v-model:value
onChange(payload: number | [number, number])拖动结束取值变化时触发