vue-range-slider

A range slider component based on vue (Vue滑块组件).

Can use the slider in vue2.x.

Live demos

Demo01

Demo02

Demo03

Demo04

Demo05

Todo

• [x] Basis
• [x] Display maximum value & minimum value
• [x] piecewise style
• [x] Compatible with PC and mobile terminal
• [x] Tooltip
• [x] The custom data
• [x] Range
• [x] The vertical component

Install

npm install vue-range-component --save

Usage

Direct <script> include

  <link rel="stylesheet" href="https://unpkg.com/vue-range-component@1.0.3/dist/vue-range-slider.min.css">
  <script src="https://unpkg.com/vue-range-component@1.0.3/dist/vue-range-slider.min.js"></script>

Use in vue project

<template>
  <div>
    <vue-range-slider ref="slider" v-model="value"></vue-range-slider>
  </div>
</template>
<script>
import 'vue-range-component/dist/vue-range-slider.css'
import VueRangeSlider from 'vue-range-component'

export default {
  data() {
    return {
      value: 1
    }
  },
  components: {
    VueRangeSlider
  }
}
</script>

Exceptions

if the component initialization in a v-show="false" / display: none container or use transform / animation / margin to change the location of the component, there may be an exception ( The slider cannot be used, because the component can not initialize the size or slider position ).

The solution:

1. using v-if instead of v-show or display: none.
2. use prop show to control display.
3. After the component appears, to call the refresh method.

Options

Props

Function

• [ index ] is the index to the array in the custom data model *
• [ index ] is equal to (( value - min ) / interval ) in normal mode *

Events

Slot

# When using the template element as a slot, can add special properties scope or slot-scope to get the value.

e.g.

<vue-range-slider v-model="value">
  <template slot="tooltip" scope="{value}">
    <div class="diy-tooltip">
      {{ value }}
    </div>
  </template>
</vue-range-slider>

<!-- In vue2.5 above, please use slot-scope instead of scope -->
<vue-range-slider v-model="value">
  <div class="diy-tooltip" slot="tooltip" slot-scope="{ value }">
    {{ value }}
  </div>
</vue-range-slider>

Using it with NUXT.js

This hack is just to avoid the server side 'document' error when using it with Nuxt.js. Use it if you don't need to have this component rendered on the server side.

1. Install this and add it to the variable components. i.e.

import NoSSR from 'vue-no-ssr'

let components = {
    /**
     * Add No Server Side Render component
     * to make client DOM math the server DOM
     */
    'no-ssr': NoSSR
}

2. In your template, encapsulate 'vue-range-slider' into the 'no-ssr' component to avoid render the html on the server like this:

<no-ssr>
    <vue-range-slider ref="slider"></vue-range-slider>
</no-ssr>

3. Require the library just for client side and add the 'vue-range-slider' component to the template component list

if (process.browser) {
    // in older versions of nuxt, it's process.BROWSER_BUILD
    let VueRangeSlider = require('vue-range-component')
    components['vue-range-slider'] = VueRangeSlider
}

4. Apply the components

export default {
    components
}

License

MIT