Can use the slider in vue1.x and vue2.x
npm install vue-slider-component
- Remove class-name & styles (can use vue native props [style, class])
- Remove val prop, use v-model set value (Don't need to manually two-way binding)
- Optimize the click range
- No longer update vue1.x, but still can be normal use
- Add
lazy
prop - Support array setIndex method parameters
- Support ie 9+
- Add props
*-style
for the custom style - Add
formatter
prop - Add
clickable
prop tooltipDir
andsliderStyle
andtooltipStyle
prop support type: Array
- Basis
- Display maximum value & minimum value
- piecewise style
- Compatible with PC and mobile terminal
- Tooltip
- The custom data
- Range
- The vertical component
cd example/
# install dependencies
npm install
# serve with hot reload at localhost:9000
npm run dev
Use in vue1.x
e.g:
<template>
<div>
<vue-slider v-ref:slider :value.sync="value"></vue-slider>
</div>
</template>
<script>
import vueSlider from 'vue-slider-component/src/vue-slider.vue';
new Vue({
el: '#app',
components: {
vueSlider
},
data: {
value: 1
}
});
</script>
Use in vue2.x
e.g:
<template>
<div>
<vue-slider ref="slider" v-model="value"></vue-slider>
</div>
</template>
<script>
import vueSlider from 'vue-slider-component'
new Vue({
el: '#app',
components: {
vueSlider
},
data: {
value: 1
}
});
</script>
Use with Browserify (vueify)
Use this little fix:
e.g:
import vueSlider from 'vue-slider-component/src/vue2-slider.vue'
Props | Type | Default | Description |
---|---|---|---|
direction | String | horizontal | set the direction of the component, optional value: ['horizontal', 'vertical'] |
event-type | String | auto | the event type, optional value: ['auto', 'touch', 'mouse', 'none'] |
width | Number[,String(in horizontal)] | auto | width of the component |
height | Number[,String(in vertical)] | 6 | height of the component |
dot-size | Number | 16 | size of the sliders |
min | Number | 0 | the minimum value |
max | Number | 100 | the maximum value |
interval | Number | 1 | the gap between the values |
show | Boolean | true | display of the component |
speed | Number | 0.5 | transition time |
disabled | Boolean | false | whether to disable components |
piecewise | Boolean | false | display of the piecewise |
tooltip | String,Boolean | false | control the tooltip, optional value: ['hover', 'always', false] |
tooltip-dir | String[,Array(in range model) | top(in horizontal)or left(in vertical) | set the direction of the tooltip, optional value: ['top', 'bottom', 'left', 'right'] |
reverse | Boolean | false | whether the component reverse (such as Right to left, Top to bottom) |
value | Number,Array | 0 | initial value (if the value for the array open range model) |
data | Array | null | the custom data. |
clickable | Boolean | true | Whether or not the slider is clickable as well as drag-able |
lazy* | Boolean | false | At the end of the drag and drop, to synchronization value (if each update to high consumption of operation (such as Ajax), it is more useful) |
formatter* | String,Function | null | Formatting a tooltip values, Example: formatter='¥{value}' or formatter: (v) => `¥${v}` . demo here |
bg-style* | Object | null | The style of the background. |
slider-style* | Object[,Array(in range model)] | null | The style of the slider. |
process-style* | Object | null | The style of the process bar. |
piecewise-style* | Object | null | The style of the piecewise dot. |
tooltip-style* | Object[,Array(in range model)] | null | The style of the tooltip. |
prop*: [only support vue2]
Name | Type | Description |
---|---|---|
setValue | Params: value | set value of the component |
setIndex | Params: index* | set index of the component |
getValue | Return: value | get value of the component |
getIndex | Return: index* | get index of the component |
refresh | null | Refresh the component |
- [ index ] is the index to the array in the custom data model *
- [ index ] is equal to (( value - min ) / interval ) in normal mode *
Name | Type | Description |
---|---|---|
callback | Params: value[Number] | values change when the callback function |
drag-start | Params: context[Object] | Drag the staUnable to initialize the width componentsrt event |
drag-end | Params: context[Object] | Drag the end event |
if the component initialization in a v-show="false"
container, will appear exception( The slider cannot be used, because the component unable to initialize the size in display: none
).
The solution:
- using
v-if
instead ofv-show
. - use prop
show
to control display. - After the set
v-show="true"
, to call therefresh
method.
for example:
this.show = true
this.$nextTick(() => {
this.$refs.slider.refresh()
})