共计 5131 个字符，预计需要花费 13 分钟才能阅读完成。
Sortable 是一个 JavaScript 库，用于在现代浏览器和触摸设备上重新排序拖放列表。不需要 jQuery。支持 Meteor, AngularJS, React, Polymer, Vue, Knockout 和任何 CSS 库, 例如 Bootstrap.
功能描述: 用于可重新排序的拖放列表的 JavaScript 库。（__JavaScript library for reorderable drag-and-drop lists__）
特性
支持触摸设备和现代浏览器 (包括 IE9)
可以从一个列表拖到另一个列表或在同一个列表中
移动元素时执行 CSS 动画
支持拖拽处理和可选文本 (比 voidberg 的 html5sortable 更好)
智能自动滚动
先进的交换检测
使用原生 HTML5 拖放 API 构建
支持 Meteor, AngularJS, React, Polymer, Vue, Knockout
支持任何 CSS 库, 例如 Bootstrap
简单的 API
CDN
不需要 jQuery(但支持)
引入
通过 npm
$ npm install sortablejs –save
CDN
<!– jsDelivr :: Sortable :: Latest (https://www.jsdelivr.com/package/npm/sortablejs) –>
<script src=”https://cdn.jsdelivr.net/npm/sortablejs@latest/Sortable.min.js”></script>
使用
<ul id=”items”>
<li>item 1</li>
<li>item 2</li>
<li>item 3</li>
</ul>
var el = document.getElementById(‘items’);
var sortable = Sortable.create(el);
您可以对任何列表及其子元素使用，而不仅仅是 ul/li。这里是一个关于 div 的例子。
Options
var sortable = new Sortable(el, {
group: “name”, // or {name: “…”, pull: [true, false, ‘clone’, array], put: [true, false, array] }
sort: true, // sorting inside list
delay: 0, // time in milliseconds to define when the sorting should start
touchStartThreshold: 0, // px, how many pixels the point should move before cancelling a delayed drag event
disabled: false, // Disables the sortable if set to true.
store: null, // @see Store
animation: 150, // ms, animation speed moving items when sorting, `0` — without animation
easing: “cubic-bezier(1, 0, 0, 1)”, // Easing for animation. Defaults to null. See https://easings.net/ for examples.
handle: “.my-handle”, // Drag handle selector within list items
filter: “.ignore-elements”, // Selectors that do not lead to dragging (String or Function)
preventOnFilter: true, // Call `event.preventDefault()` when triggered `filter`
draggable: “.item”, // Specifies which items inside the element should be draggable
ghostClass: “sortable-ghost”, // Class name for the drop placeholder
chosenClass: “sortable-chosen”, // Class name for the chosen item
dragClass: “sortable-drag”, // Class name for the dragging item
dataIdAttr: ‘data-id’,
swapThreshold: 1, // Threshold of the swap zone
invertSwap: false, // Will always use inverted swap zone if set to true
invertedSwapThreshold: 1, // Threshold of the inverted swap zone (will be set to swapThreshold value by default)
direction: ‘horizontal’, // Direction of Sortable (will be detected automatically if not given)
forceFallback: false, // ignore the HTML5 DnD behaviour and force the fallback to kick in
fallbackClass: “sortable-fallback”, // Class name for the cloned DOM Element when using forceFallback
fallbackOnBody: false, // Appends the cloned DOM Element into the Document’s Body
fallbackTolerance: 0, // Specify in pixels how far the mouse should move before it’s considered as a drag.
scroll: true, // or HTMLElement
scrollFn: function(offsetX, offsetY, originalEvent, touchEvt, hoverTargetEl) {…}, // if you have custom scrollbar scrollFn may be used for autoscrolling
scrollSensitivity: 30, // px, how near the mouse must be to an edge to start scrolling.
scrollSpeed: 10, // px
bubbleScroll: true, // apply autoscroll to all parent elements, allowing for easier movement
dragoverBubble: false,
removeCloneOnHide: true, // Remove the clone element when it is not showing, rather than just hiding it
emptyInsertThreshold: 5, // px, distance mouse must be from empty sortable to insert drag element into it
setData: function (/** DataTransfer */dataTransfer, /** HTMLElement*/dragEl) {
dataTransfer.setData(‘Text’, dragEl.textContent); // `dataTransfer` object of HTML5 DragEvent
},
// Element is chosen
onChoose: function (/**Event*/evt) {
evt.oldIndex; // element index within parent
},
// Element is unchosen
onUnchoose: function(/**Event*/evt) {
// same properties as onEnd
},
// Element dragging started
onStart: function (/**Event*/evt) {
evt.oldIndex; // element index within parent
},
// Element dragging ended
onEnd: function (/**Event*/evt) {
var itemEl = evt.item; // dragged HTMLElement
evt.to; // target list
evt.from; // previous list
evt.oldIndex; // element’s old index within old parent
evt.newIndex; // element’s new index within new parent
evt.clone // the clone element
evt.pullMode; // when item is in another sortable: `”clone”` if cloning, `true` if moving
},
// Element is dropped into the list from another list
onAdd: function (/**Event*/evt) {
// same properties as onEnd
},
// Changed sorting within list
onUpdate: function (/**Event*/evt) {
// same properties as onEnd
},
// Called by any change to the list (add / update / remove)
onSort: function (/**Event*/evt) {
// same properties as onEnd
},
// Element is removed from the list into another list
onRemove: function (/**Event*/evt) {
// same properties as onEnd
},
// Attempt to drag a filtered element
onFilter: function (/**Event*/evt) {
var itemEl = evt.item; // HTMLElement receiving the `mousedown|tapstart` event.
},
// Event when you move an item in the list or between lists
onMove: function (/**Event*/evt, /**Event*/originalEvent) {
// Example: https://jsbin.com/nawahef/edit?js,output
evt.dragged; // dragged HTMLElement
evt.draggedRect; // DOMRect {left, top, right, bottom}
evt.related; // HTMLElement on which have guided
evt.relatedRect; // DOMRect
evt.willInsertAfter; // Boolean that is true if Sortable will insert drag element after target by default
originalEvent.clientY; // mouse position
// return false; — for cancel
// return -1; — insert before target
// return 1; — insert after target
},
// Called when creating a clone of element
onClone: function (/**Event*/evt) {
var origEl = evt.item;
var cloneEl = evt.clone;
},
// Called when dragging element changes position
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
}
});
更多
更多使用方法请参考__官方使用示例__ https://sortablejs.github.io/Sortablegit 仓库地址 https://github.com/SortableJS/Sortable