Skip to content
On this page

组件库文档 tmui.design

滑块 Slider

Slider 滑块是一个用于输入数值,或区域选择数值的组件


🌶️ 滑块 Slider 示例

查看模拟效果
示例模板
vue
<template>
	<tm-app>
		<tm-sheet>
			<tm-text :font-size="24" _class="text-weight-b" label="基础示例,更多见文档"></tm-text>
			<tm-divider></tm-divider>
			<tm-slider :min="50" color="primary" :width="600" :height="6" :defaultValue="80"></tm-slider>
			<tm-slider color="red" :width="600" :height="6" :defaultValue="20"></tm-slider>
			<tm-slider color="white" :width="600" :height="6" :defaultValue="50"></tm-slider>
		</tm-sheet>
		<tm-sheet>
			<tm-text :font-size="24" _class="text-weight-b" label="双向滑块"></tm-text>
			<tm-divider></tm-divider>
			<view class="flex flex-row flex-row-cneter-center">
				<tm-slider color="white" :width="300" :height="6" :defaultValue="[10, 50]"></tm-slider>
			</view>
		</tm-sheet>
		<tm-sheet>
			<tm-text :font-size="24" _class="text-weight-b" label="标签,格式化显示,拖动将显示百分比"></tm-text>
			<tm-divider></tm-divider>
			<tm-slider  :formart="formart" :step="5" showLabel color="green" :width="600" :height="6" :defaultValue="[5, 50]"></tm-slider>
		</tm-sheet>
	</tm-app>
</template>
<script lang="ts" setup>
import { ref, computed } from 'vue'
import { onShow, onLoad } from '@dcloudio/uni-app'
import tmApp from '@/tmui/components/tm-app/tm-app.vue'
import tmSheet from '@/tmui/components/tm-sheet/tm-sheet.vue'
import tmText from '@/tmui/components/tm-text/tm-text.vue'
import tmSlider from '@/tmui/components/tm-slider/tm-slider.vue'
import tmDivider from '@/tmui/components/tm-divider/tm-divider.vue'
function formart(val) {
	return val + '%'
}
</script>

🌶️ 兼容性

APP-VUEAPP-NVUE小程序WEB/H5VUE3/TS
✔️✔️✔️✔️✔️

🌱 参数

本组件含有公共属性 公共属性

参数名类型默认值描述
widthNumber500组件宽度
heightNumber8组件高度
buttonSizeNumber46按钮的大小
directionStringhorizontalhorizontal:水平,vertical:竖向
colorStringprimary按钮颜色以及按钮左侧滑块的颜色
bgColorStringgrey-4按钮右侧滑块条的颜色
maxNumber100滑块可选值的最大数值
minNumber0滑块可选值的最小数值
modelValue / v-model:[Array,Number]0双向绑定值必须与defaultValue 相同
defaultValue:[Array,Number]0步进器默认值,必须与modelValue 类型相同,当提供为数组比如[0,25],此时该组件会变成双滑块,如果是一个数字为单滑块。
formartFunctionmodelValue是一个函数,返回值为按钮上方显示的标签内容,默认与modelValue内容相同
showLabelBooleanfalse为true时step有效,会显示标签
stepNumber5需要显示的步骤标签
disabledBooleanfalse是否禁用组件

🌹 事件

事件名参数返回数据描述
change/modelValue滑块数值改变时,返回当前选中的数值,与modelValue相同

🌽 slot插槽

🥗 ref方法

😡 贡献者

Wicos