SortableJS是功能强大的JavaScript 拖拽库
其特点为:
兼容性好-支持触屏设备和大部分浏览器简单-简单的API,方便使用原生-基于原生HTML5中的拖放APICSS框架兼容性-支持所有的css框架,像Bootstrap零依赖-不依赖Jquery等其他框架SPA支持良好-支持多种框架(angular、vue、react等)
安装
npm install sortablejs --save
配置函数
setSort() {const el = document.querySelectorAll('.el-table__body-wrapper > table > tbody')[0];Sortable.create(el, {disabled: !this.enableDrag,ghostClass: 'sortable-ghost',setData: function(dataTransfer) {dataTransfer.setData('Text', '');},onEnd: (evt) => {}});},
我们在数据加载完成之后,就调用setSort() 方法来开启拖拽排序功能。
有关配置的细节:
var sortable = new Sortable(el, {group: "name", // or { name: "...", pull: [true, false, 'clone', array], put: [true, false, array] }sort: true, // boolean 定义是否列表单元是否可以在列表容器内进行拖拽排序delay: 0, // number 定义鼠标选中列表单元可以开始拖动的延迟时间;touchStartThreshold: 0, // px, how many pixels the point should move before cancelling a delayed drag eventdisabled: false, // boolean 定义是否此sortable对象是否可用,为true时sortable对象不能拖放排序等功能,为false时为可以进行排序,相当于一个开关;store: null, // @see Storeanimation: 150, // ms, number 单位:ms,定义排序动画的时间easing: "cubic-bezier(1, 0, 0, 1)", // Easing for animation. Defaults to null. See / for examples.handle: ".my-handle", // 格式为简单css选择器的字符串,使列表单元中符合选择器的元素成为拖动的手柄,只有按住拖动手柄才能使列表单元进行拖动filter: ".ignore-elements", // 过滤器,不需要进行拖动的元素preventOnFilter: true, // 在触发过滤器`filter`的时候调用`event.preventDefault()`draggable: ".item", // 允许拖拽的项目类名ghostClass: "sortable-ghost", // drop placeholder的css类名chosenClass: "sortable-chosen", // 被选中项的css 类名dragClass: "sortable-drag", // 正在被拖拽中的css类名dataIdAttr: 'data-id',swapThreshold: 1, // Threshold of the swap zoneinvertSwap: false, // Will always use inverted swap zone if set to trueinvertedSwapThreshold: 1, // Threshold of the inverted swap zone (will be set to swapThreshold value by default)direction: 'horizontal', // 拖拽方向 (默认情况下会自动判断方向)forceFallback: false, // 忽略 HTML5拖拽行为,强制回调进行fallbackClass: "sortable-fallback", // 当使用forceFallback的时候,被复制的dom的css类名fallbackOnBody: false, // 将cloned DOM 元素挂到body元素上。fallbackTolerance: 0, // Specify in pixels how far the mouse should move before it's considered as a drag.scroll: true, // or HTMLElementscrollFn: function(offsetX, offsetY, originalEvent, touchEvt, hoverTargetEl) {...}, // if you have custom scrollbar scrollFn may be used for autoscrollingscrollSensitivity: 30, // px, how near the mouse must be to an edge to start scrolling.scrollSpeed: 10, // pxbubbleScroll: true, // apply autoscroll to all parent elements, allowing for easier movementdragoverBubble: false,removeCloneOnHide: true, // Remove the clone element when it is not showing, rather than just hiding itemptyInsertThreshold: 5, // px, distance mouse must be from empty sortable to insert drag element into itsetData: function( /** DataTransfer */ dataTransfer, /** HTMLElement*/ dragEl) {dataTransfer.setData('Text', dragEl.textContent); // `dataTransfer` object of HTML5 DragEvent},// 元素被选中onChoose: function( /**Event*/ evt) {evt.oldIndex; // element index within parent},// 元素未被选中的时候(从选中到未选中)onUnchoose: function( /**Event*/ evt) {// same properties as onEnd},// 开始拖拽的时候onStart: function( /**Event*/ evt) {evt.oldIndex; // element index within parent},// 结束拖拽onEnd: function( /**Event*/ evt) {var itemEl = evt.item; // dragged HTMLElementevt.to; // target listevt.from; // previous listevt.oldIndex; // element's old index within old parentevt.newIndex; // element's new index within new parentevt.clone // the clone elementevt.pullMode; // when item is in another sortable: `"clone"` if cloning, `true` if moving},// 元素从一个列表拖拽到另一个列表onAdd: function( /**Event*/ evt) {// same properties as onEnd},// 列表内元素顺序更新的时候触发onUpdate: function( /**Event*/ evt) {// same properties as onEnd},// 列表的任何更改都会触发onSort: function( /**Event*/ evt) {// same properties as onEnd},// 元素从列表中移除进入另一个列表onRemove: function( /**Event*/ evt) {// same properties as onEnd},// 试图拖拽一个filtered的元素onFilter: function( /**Event*/ evt) {var itemEl = evt.item; // HTMLElement receiving the `mousedown|tapstart` event.},// 拖拽移动的时候onMove: function( /**Event*/ evt, /**Event*/ originalEvent) {// Example: /nawahef/edit?js,outputevt.dragged; // dragged HTMLElementevt.draggedRect; // DOMRect {left, top, right, bottom}evt.related; // HTMLElement on which have guidedevt.relatedRect; // DOMRectevt.willInsertAfter; // Boolean that is true if Sortable will insert drag element after target by defaultoriginalEvent.clientY; // mouse position// return false; ? for cancel// return -1; ? insert before target// return 1; ? insert after target},// clone一个元素的时候触发onClone: function( /**Event*/ evt) {var origEl = evt.item;var cloneEl = evt.clone;},// 拖拽元素改变位置的时候onChange: function( /**Event*/ evt) {evt.newIndex // most likely why this event is used is to get the dragging element's current index// same properties as onEnd}});
group:string or object
string: 命名, 个人建议用元素id就行, 用处是为了设置可以拖放容器时使用, 在array中的put的设置中再做介绍;object: {name,pull,put}name: 同string的方法,pull: pull用来定义从这个列表容器移动出去的设置, true / false / 'clone' / functiontrue: 列表容器内的列表单元可以被移出;false: 列表容器内的列表单元不可以被移出;'clone':列表单元移出, 移动的为该元素的副本;function: 用来进行pull的函数判断, 可以进行复杂逻辑, 在函数中return false / true来判断是否移出;put: put用来定义往这个列表容器放置列表单元的的设置, true / false / ['foo', 'bar'] / functiontrue: 列表容器可以从其他列表容器内放入列表单元;false: 与true相反;['foo', 'bar']: 这个可以是一个字符串或者是字符串的数组, 代表的是group配置项里定义的name值;function: 用来进行put的函数判断, 可以进行复杂逻辑, 在函数中return false / true来判断是否放入;
sort:boolean 定义是否列表单元是否可以在列表容器内进行拖拽排序;
delay:number 定义鼠标选中列表单元可以开始拖动的延迟时间;
disabled:boolean 定义是否此sortable对象是否可用,为true时sortable对象不能拖放排序等功能,为false时为可以进行排序,相当于一个开关;
animation:number 单位:ms,定义排序动画的时间;
handle:selector 格式为简单css选择器的字符串,使列表单元中符合选择器的元素成为拖动的手柄,只有按住拖动手柄才能使列表单元进行拖动;
filter:selector 格式为简单css选择器的字符串,定义哪些列表单元不能进行拖放,可设置为多个选择器,中间用“,”分隔;
draggable:selector 格式为简单css选择器的字符串,定义哪些列表单元可以进行拖放
ghostClass:selector 格式为简单css选择器的字符串,当拖动列表单元时会生成一个副本作为影子单元来模拟被拖动单元排序的情况,此配置项就是来给这个影子单元添加一个class,我们可以通过这种方式来给影子元素进行编辑样式;
chosenClass:selector 格式为简单css选择器的字符串,当选中列表单元时会给该单元增加一个class;
forceFallback:boolean 如果设置为true时,将不使用原生的html5的拖放,可以修改一些拖放中元素的样式等;
fallbackClass:string 当forceFallback设置为true时,拖放过程中鼠标附着单元的样式;
scroll:boolean 默认为true,当排序的容器是个可滚动的区域,拖放可以引起区域滚动
事件
onChoose:function 列表单元被选中的回调函数
onStart:function 列表单元拖动开始的回调函数
onEnd:function 列表单元拖放结束后的回调函数
onAdd:function 列表单元添加到本列表容器的回调函数
onUpdate:function 列表单元在列表容器中的排序发生变化后的回调函数
onRemove:function 列表元素移到另一个列表容器的回调函数
onFilter:function 试图选中一个被filter过滤的列表单元的回调函数
onMove:function 当移动列表单元在一个列表容器中或者多个列表容器中的回调函数
onClone:function 当创建一个列表单元副本的时候的回调函数