Skip to content

LimeSlider 滑动输入条

  • 滑动型输入器,展示当前值和可选范围、区间、档位。兼容uniapp/uniappx
  • 插件依赖lime-sharedlime-style,不喜勿下

安装

插件市场入口 导入即可,首次导入可能需要重新编译

文档

slider

代码演示

基础使用

html
<l-slider v-model="value" @change="onChange" />
js
const value = ref(50);
const onChange = (value: number) => {
	console.log('当前值:' + value)
};

双滑块

添加 range 属性就可以开启双滑块模式,确保 value 的值是一个数组。

html
<van-slider v-model="value" :range="true" @change="onChange" />
js
// 双滑块模式时,值必须是数组
const value = ref([10, 50]);
const onChange = (value: number[]) => {
	console.log('当前值:' + value)
};

指定范围

通过设置 min 属性和max达到指定范围。

html
<l-slider v-model="value" :min="-50" :max="50"/>

禁用

通过设置 disabled属性禁用。

html
<l-slider v-model="value4" :disabled="true" />

指定步长

通过设置 step 属性值指定步长。

html
<l-slider v-model="value" :step="10" />

自定义样式

通过 thumb-size 属性设置按钮尺寸,通过rail-size设置进度条高度,通过track-color可设置进度条激活态颜色。

html
<l-slider v-model="value" thumb-size="30px" rail-size="4px" track-color="#34c471" />

自定义按钮

通过 startThumb 插槽自定义按钮。

html
<l-slider v-model="value" rail-size="4px" track-color="#ffb400">
	<template #startThumb>
		<text class="custom-thumb">{{ value }}</text>
	</template>
</l-slider>

垂直方向

设置 vertical 属性后,滑块会垂直展示,且高度为 100% 父元素高度。

html
<l-slider v-model="value" :range="true" :vertical="true"/>

插件标签

  • 默认 l-slider 为 component
  • 默认 lime-slider 为 demo

关于vue2的使用方式

  • 插件使用了composition-api, 如果你希望在vue2中使用请按官方的教程vue-composition-api配置
  • 关键代码是: 在main.js中 在vue2部分加上这一段即可.
js
// vue2
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

API

Props

参数说明类型默认值
v-model当前分值number-
value当前分值number-
max最大值number100
min最小值number0
step步长number0
step步长number1
vertical是否垂直展示booleanfalse
disabled是否禁用滑块booleanfalse
range是否开启双滑块模式booleanfalse
thumbSize滑块按钮大小string-
thumbColor滑块按钮颜色string-
thumbBorderColor滑块按钮描边颜色string-
thumbRadius滑块按钮圆角string-
railColor进度条轨道颜色string-
railRadius进度条轨道圆角string-
railSize进度条轨道尺寸string-
trackColor进度条激活态颜色string-

Events

事件名说明回调参数
change当前分值变化时触发的事件currentValue: number|number[]
dragend结束拖动时触发currentValue: number|number[]
dragstart开始拖动时触发

Slots

名称说明
startThumb左边插槽
endThumb右边插槽

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式)。uvue app无效。

名称默认值描述
--l-slider-rail-size:20px-
--l-slider-rail-color:$fill-2-
--l-slider-rail-color:99px-
--l-slider-track-color:$primary-color-
--l-slider-thumb-size:12px-
--l-slider-thumb-color:white-
--l-slider-thumb-radius:99px-
--l-slider-thumb-border-color:$gray-1-

打赏

如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。

源代码

组件源码