Slider 滑块选择器

概述

Slider 滑块选择器，用于在一个区间内选择特定值。

App-vue	App-Nvue	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序	H5	PC	快手小程序	钉钉小程序
✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

温馨提示

字节小程序边缘侧滑返回事件与touch事件有冲突（设置tt.setSwipeBackMode(0)也不行），所以在字节小程序中组件不要靠屏幕边缘太近。

以下介绍两种常用的引入方式。

第一种：在页面中引用、注册

import fuiSlider from "@/components/firstui/fui-slider/fui-slider.vue"
export default {
	components:{
		fuiSlider
	}
}

1
2
3
4
5
6

第二种：easycom组件规范

传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。easycom将其精简为一步。

First UI easycom配置请查看快速上手。

如果不了解easycom，可先查看官网文档 (opens new window)。

部分示例演示，完整使用请参考示例程序以及文档API。

基础使用

通过 @change 事件得到选择结果，@changing 事件为实时返回选择数据。

<fui-slider @change="onChange" @changing="onChanging"></fui-slider>

methods: {
	onChange(e) {
		console.log(e)
		this.fui.toast(`您选择的值为：${e.value}`)
	},
	//需要实时数据时使用
	onChanging(e) {
		//console.log(e)
	}
}

1
2
3
4
5
6
7
8
9
10

初始值/显示value

通过 value 属性设置初始值，showValue 属性设置是否显示value值。

<fui-slider :value="50" showValue></fui-slider>

区间选择

通过 showValue 属性设置是否显示value值，section 属性设置是否为区间选择。

<fui-slider showValue section @change="sectionChange"></fui-slider>

methods: {
	//区间选择返回数据
	sectionChange(e) {
		console.log(e)
	}
}

1
2
3
4
5
6

插槽名称	说明
-	-

属性名	类型	说明	默认值	平台差异说明
width	Number, String	slider宽度，单位px	240	-
height	Number, String	slider高度，单位px	2	-
radius	Number, String	slider圆角值，单位px	2	-
min	Number, String	最小值	0	-
max	Number, String	最大值	100	-
step	Number, String	步长，取值必须大于 0，并且可被(max - min)整除	1	-
value	Number, String	当前取值（起始值）	0	-
section	Boolean	是否为区间选择	false	-
endValue	Number, String	当前取值（结束值），section为true时生效	100	-
background	String	slider未选择时背景颜色	#e1e1e1	-
activeColor	String	slider已选择部分背景颜色	#465CFF	非Nvue端默认为空，可使用css变量（--fui-color-primary）来改变颜色值
blockWidth	Number, String	滑块宽度，单位px	24	-
blockHeight	Number, String	滑块高度，单位px	24	-
blockColor	String	滑块背景颜色	#fff	-
blockRadius	Number, String	滑块圆角值，单位px	12	-
disabled	Boolean	是否禁止滑动选择/仅展示	false	-
showValue	Boolean	是否显示value值	false	-
valueWidth	Number, String	value框宽度，单位px	32	-
valueSize	Number, String	value字体大小，单位px	14	-
valueColor	String	value字体颜色	#333	-

事件名	说明	回调参数
@change	滑动结束时触发	{ value : 选择值/起始值 endValue : 结束值，section为true时返回 }
@changing	滑动时触发，实时数据	{ value : 选择值/起始值 endValue : 结束值，section为true时返回 }

该组件为付费组件，UNI-APP版VIP用户可免费使用。