2.8.0 • Published 7 months ago

vue-virtual-draglist-lock-axis-fork v2.8.0

Weekly downloads
-
License
MIT
Repository
github
Last release
7 months ago

vue-virtual-draglist

npm npm vue2 Software License

A virtual scrolling list component that can be sorted by dragging

For Vue 3 support, see here

Live demo

Simple usage

npm i vue-virtual-draglist

Root component:

<template>
  <div>
    <!--
      :handle="'I'" // use tagName 
      :handle="'.handle'" // use class
      :handle="'#handle'" // use id
      :data-source="list" // or replace with `v-model`
    -->
    <virtual-drag-list
      v-model="list"
      :data-key="'id'"
      :handle="'.handle'"
      style="height: 500px"
      @top="handleToTop"
      @bottom="handleToBottom"
      @drag="onDrag"
      @drop="onDrop"
      @add="onAdd"
      @remove="onRemove"
    >
      <template slot="item" slot-scope="{ record, index, dataKey }">
        <i class="handle">{{ record.id }}</span>
        {{ record.text }}
      </template>
      <template slot="header">
        <div class="loading">top loading...</div>
      </template>
      <template slot="footer">
        <div class="loading">bottom loading...</div>
      </template>
    </virtual-drag-list>
  </div>
</template>

<script>
  import virtualDragList from 'vue-virtual-draglist'

  export default {
    name: 'root',
    components: { virtualDragList },
    data () {
      return {
        list: [{id: '1', text: 'asd'}, {id: '2', text: 'fgh'}, ...]
      }
    },
    methods: {
      handleToTop() {
        // code here
      },
      handleToBottom() {
        // code here
      },
      onDrag({ list, from }) {
        // code here
      },
      onDrop({ list, from, to, changed }) {
        // code here
      },
      onAdd({ item, key, index }) {
        // code here
      },
      onRemove({ item, key, index }) {
        // code here
      }
    }
  }
</script>

Emits

EmitDescription
topEvent fired when scroll to top
bottomEvent fired when scroll to bottom
dragEvent fired when the drag is started
dropEvent fired when the drag is completed
addEvent fired when element is dropped into the list from another
removeEvent fired when element is removed from the list into another

Props

Required props

PropTypeDescription
data-keyStringThe unique identifier of each piece of data, in the form of 'a.b.c'
data-sourceArrayThe data that needs to be rendered

Optional props

Commonly used

PropTypeDefaultDescription
keepsNumber30The number of lines rendered by the virtual scroll
sizeNumber-The estimated height of each piece of data, you can choose to pass it or not, it will be automatically calculated
handleFunction/String-Drag handle selector within list items
groupFunction/String-string: 'name' or object: { name: 'group', put: true/false, pull: true/false }
keepOffsetBooleanfalseWhen scrolling up to load data, keep the same offset as the previous scroll
directionStringverticalvertical/horizontal, scroll direction
pageModeBooleanfalseLet virtual list using global document to scroll through the list

Uncommonly used

PropTypeDefaultDescription
draggableFunction/String-Specifies which items inside the element should be draggable. If does not set a value, the default list element can be dragged
disabledBooleanfalseDisables the sortable if set to true
delayNumber0Delay time of debounce function
animationNumber150Animation speed moving items when sorting
autoScrollBooleantrueAutomatic scrolling when moving to the edge of the container
scrollThresholdNumber55Threshold to trigger autoscroll
pressDelayNumber0Time in milliseconds to define when the sorting should start
pressDelayOnTouchOnlyBooleanfalseOnly delay on press if user is using touch
fallbackOnBodyBooleanfalseAppends the ghost element into the document's body
rootTagStringdivLabel type for root element
wrapTagStringdivLabel type for list wrap element
itemTagStringdivLabel type for list item element
headerTagStringdivLabel type for header slot element
headerStyleObject{}Header slot element style
footerTagStringdivLabel type for footer slot element
footerStyleObject{}Footer slot element style
wrapClassString''List wrapper element class
wrapStyleObject{}List wrapper element style
itemClassString''List item element class
itemStyleObject{}List item element style
ghostClassString''The class of the mask element when dragging
ghostStyleObject{}The style of the mask element when dragging
chosenClassString''The class of the selected element when dragging

Methods

Use ref to get the method inside the component

MethodDescription
getSize(key)Get the size of the current item by unique key value
getOffset()Get the current scroll height
getClientSize()Get wrapper element client viewport size (width or height)
getScrollSize()Get all scroll size (scrollHeight or scrollWidth)
scrollToTop()Scroll to top of list
scrollToBottom()Scroll to bottom of list
scrollToIndex(index)Scroll to the specified index position
scrollToOffset(offset)Scroll to the specified offset