0.0.2 • Published 7 years ago

vue-slider-zkteam v0.0.2

Weekly downloads
5
License
-
Repository
github
Last release
7 years ago

vue-slider-component

build build build

Can use the slider in vue1.x and vue2.x

Live Demo

Install

npm install vue-slider-component --save

Update

  • 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 and sliderStyle and tooltipStyle prop support type: Array
  • Add real-time prop for real-time computing the layout of the components
  • Add labels of piecewise, and the style of the corresponding

Todo

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

Example

cd example/

# install dependencies
npm install

# serve with hot reload at localhost:9000
npm run dev

usage

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>

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>

e.g:

import vueSlider from 'vue-slider-component/src/vue2-slider.vue'

Options

Props

PropsTypeDefaultDescription
directionStringhorizontalset the direction of the component, optional value: 'horizontal', 'vertical'
event-typeStringautothe event type, optional value: 'auto', 'touch', 'mouse', 'none'
widthNumber,String(in horizontal)autowidth of the component
heightNumber,String(in vertical)6height of the component
dot-sizeNumber16size of the sliders
minNumber0the minimum value
maxNumber100the maximum value
intervalNumber1the gap between the values
showBooleantruedisplay of the component
speedNumber0.5transition time
disabledBooleanfalsewhether to disable components
piecewiseBooleanfalsewhether to display the piecewise
piecewise-label*Booleanfalsewhether to display the label. demo here
tooltipString, Booleanfalsecontrol the tooltip, optional value: 'hover', 'always', false
tooltip-dirString[,Array(in range model)top(in horizontal)or left(in vertical)set the direction of the tooltip, optional value: 'top', 'bottom', 'left', 'right'
reverseBooleanfalsewhether the component reverse (such as Right to left, Top to bottom)
valueNumber,Array0initial value (if the value for the array open range model)
dataArraynullthe custom data.
clickableBooleantrueWhether or not the slider is clickable as well as drag-able
real-time*BooleanfalseWhether the real-time computing the layout of the components
lazy*BooleanfalseAt 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,FunctionnullFormatting a tooltip values, Example: formatter='¥{value}' or formatter: (v) => `¥${v}`. demo here
bg-style*ObjectnullThe style of the background.
slider-style*Object,Array(in range model)nullThe style of the slider.
process-style*ObjectnullThe style of the process bar.
piecewise-style*ObjectnullThe style of the piecewise dot.
piecewise-active-style*ObjectnullThe style of the piecewise dot in the activated state.
tooltip-style*Object,Array(in range model)nullThe style of the tooltip.
label-style*ObjectnullThe style of the label.
label-active-style*ObjectnullThe style of the label in the activated state.

prop*: only support vue2

Function

NameTypeDescription
setValueParams: valueset value of the component
setIndexParams: index*set index of the component
getValueReturn: valueget value of the component
getIndexReturn: index*get index of the component
refreshnullRefresh the component
  • index is the index to the array in the custom data model *
  • index is equal to (( value - min ) / interval ) in normal mode *

Events

NameTypeDescription
callbackParams: valueNumbervalues change when the callback function
drag-startParams: contextObjectDrag the staUnable to initialize the width componentsrt event
drag-endParams: contextObjectDrag the end event

Exceptions

if the component initialization in a v-show="false" / display: none container or use transform / animation to appear 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. set prop :real-time="true", if the initial value not equal to the minimum, need to call the refresh method 2. using v-if instead of v-show or display: none. 3. use prop show to control display. 4. After the component appears, to call the refresh method.

License

MIT