Slider 滑块

使用指南

在 app.json 或 index.json 中引入组件

  1. "usingComponents": {
  2. "van-slider": "/packages/slider/index"
  3. }

基本用法

  1. <van-slider value="50" bind:change="onChange" />
  1. Page({
  2. onChange(event) {
  3. wx.showToast({
  4. icon: 'none',
  5. title: `当前值:${event.detail}`
  6. });
  7. }
  8. });

指定选择范围

  1. <van-slider value="50" min="10" max="90" />

禁用

  1. <van-slider value="50" disabled />

指定步长

  1. <van-slider value="50" step="10" />

自定义样式

  1. <van-slider
  2. value="50"
  3. bar-height="4px"
  4. active-color="#f44"
  5. />

自定义按钮

  1. <van-slider
  2. value="{{ currentValue }}"
  3. use-button-slot
  4. bind:drag="onDrag"
  5. >
  6. <view class="custom-button" slot="button">
  7. {{ currentValue }}/100
  8. </view>
  9. </van-slider>
  1. Page({
  2. data: {
  3. currentValue: 50
  4. },
  5. onDrag(event) {
  6. this.setData({
  7. currentValue: event.detail.value
  8. });
  9. }
  10. });

自定义按钮

  1. <van-slider
  2. value="{{ currentValue }}"
  3. use-button-slot
  4. bind:drag="onDrag"
  5. >
  6. <view class="custom-button" slot="button">
  7. {{ currentValue }}/100
  8. </view>
  9. </van-slider>
  1. Page({
  2. data: {
  3. currentValue: 30
  4. },
  5. onDrag(event) {
  6. this.setData({
  7. currentValue: event.detail.value
  8. });
  9. }
  10. });

API

参数说明类型默认值
value当前进度百分比,取值范围为 0-100Number0
disabled是否禁用滑块Booleanfalse
max最大值Number100
min最小值Number0
step步长Number1
bar-height进度条高度String2px
active-color进度条激活态颜色String#1989fa
inactive-color进度条默认颜色String#e5e5e5

Event

事件名说明参数
bind:drag拖动进度条时触发event.detail.value: 当前进度
bind:change进度值改变后触发event.detail: 当前进度

外部样式类

类名说明
custom-class根节点样式类

更新日志

版本类型内容
0.2.0feature新增组件

原文: https://youzan.github.io/vant-weapp/#/slider