Slider 滑块

介绍

滑动输入条，用于在给定的范围内选择一个值。

引入

在app.json或index.json中引入组件，详细介绍见快速上手。

"usingComponents": {
  "van-slider": "@vant/weapp/slider/index"
}

代码演示

基本用法

<van-slider value="50" bind:change="onChange" />

Page({
  onChange(event) {
    wx.showToast({
      icon: 'none',
      title: `当前值：${event.detail}`,
    });
  },
});

双滑块

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

<van-slider value="{{ 10, 50 }}" range @change="onChange" />

Page({
  onChange(event) {
    wx.showToast({
      icon: 'none',
      title: `当前值：${event.detail}`,
    });
  },
});

指定选择范围

<van-slider min="-50" max="50" />

禁用

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

指定步长

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

自定义样式

<van-slider value="50" bar-height="4px" active-color="#ee0a24" />

自定义按钮

<van-slider value="{{ currentValue }}" use-button-slot bind:drag="onDrag">
  <view class="custom-button" slot="button">{{ currentValue }}/100</view>
</van-slider>

Page({
  data: {
    currentValue: 50,
  },
  onDrag(event) {
    this.setData({
      currentValue: event.detail.value,
    });
  },
});

垂直方向

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

<view style="height: 150px;">
  <van-slider value="50" vertical bind:change="onChange" />
  <van-slider
    value="{{ [10, 50] }}"
    range
    vertical
    style="margin-left: 100px;"
    bind:change="onChange"
  />
</view>

Page({
  onChange(event) {
    wx.showToast({
      icon: 'none',
      title: `当前值：${event.detail}`,
    });
  },
});

API

Props

Events

外部样式类

Slots