Skip to content

slider ​

滑动选择器。

属性说明

属性名类型默认值说明
minNumber0最小值
maxNumber100最大值
stepNumber1步长,取值必须大于 0,并且可被(max - min)整除
disabledBooleanfalse是否禁用
valueNumber0当前取值
activeColorColor各个平台不同,详见下滑块左侧已选择部分的线条颜色
backgroundColorColor#e9e9e9滑块右侧背景条的颜色
block-sizeNumber28滑块的大小,取值范围为 12 - 28
block-colorColor#ffffff滑块的颜色
show-valueBooleanfalse是否显示当前 value
@changeEventHandle完成一次拖动后触发的事件,event.detail = {value: value}
@changingEventHandle拖动过程中触发的事件,event.detail = {value: value}

Tips

  • activeColor 默认值在不同平台不一样,微信是 #1aad19 (绿色),头条是红色,其他平台是 #007aff(蓝色)
  • 如需要区间滑块,即一根横条上使用2个滑块选择一段范围,可见插件市场

示例 查看演示

以下示例代码,来自于hello uni-app项目,推荐使用HBuilderX,新建uni-app项目,选择hello uni-app模板,可直接体验完整示例。

vue
<template>
  <view>
    <view class="uni-padding-wrap uni-common-mt">
      <view class="uni-title">设置step</view>
      <view>
        <slider
          value="60"
          @change="sliderChange"
          step="5"
        />
      </view>

      <view class="uni-title">显示当前value</view>
      <view>
        <slider
          value="50"
          @change="sliderChange"
          show-value
        />
      </view>

      <view class="uni-title">设置最小/最大值</view>
      <view>
        <slider
          value="100"
          @change="sliderChange"
          min="50"
          max="200"
          show-value
        />
      </view>

      <view class="uni-title">不同颜色和大小的滑块</view>
      <view>
        <slider
          value="50"
          @change="sliderChange"
          activeColor="#FFCC33"
          backgroundColor="#000000"
          block-color="#8A6DE9"
          block-size="20"
        />
      </view>
    </view>
  </view>
</template>
<template>
  <view>
    <view class="uni-padding-wrap uni-common-mt">
      <view class="uni-title">设置step</view>
      <view>
        <slider
          value="60"
          @change="sliderChange"
          step="5"
        />
      </view>

      <view class="uni-title">显示当前value</view>
      <view>
        <slider
          value="50"
          @change="sliderChange"
          show-value
        />
      </view>

      <view class="uni-title">设置最小/最大值</view>
      <view>
        <slider
          value="100"
          @change="sliderChange"
          min="50"
          max="200"
          show-value
        />
      </view>

      <view class="uni-title">不同颜色和大小的滑块</view>
      <view>
        <slider
          value="50"
          @change="sliderChange"
          activeColor="#FFCC33"
          backgroundColor="#000000"
          block-color="#8A6DE9"
          block-size="20"
        />
      </view>
    </view>
  </view>
</template>
js
<script>
export default {
  methods: {
    sliderChange(e) {
      console.log('value 发生变化:' + e.detail.value);
    },
  },
};
</script>
<script>
export default {
  methods: {
    sliderChange(e) {
      console.log('value 发生变化:' + e.detail.value);
    },
  },
};
</script>