拖放排序插件Sortable.js

介紹

Sortable.js是一款輕量級的拖放排序列表的js插件（雖然體積小，可是功能很強大）
下載地址：https://github.com/RubaXa/Sor...
官方DEMO：http://rubaxa.github.io/Sorta...

---

特色

• 支持觸屏設備和大部分瀏覽器（IE9如下的就不支持了，緣由都懂得）
• 能夠從一個列表容器中拖拽一個列表單元到其餘容器或本列表容器中進行排序
• 移動列表單元時有css動畫
• 支持拖放操做和可選擇的文本（這句我也沒理解，大概意思就是對原生的拖放進行拓展了）
• 很是友善的滾動效果
• 基於原生HTML5中的拖放API
• 支持多種框架（angular、vue、react等）
• 支持全部的css框架，像Bootstrap
• 簡單的API，方便使用
• CDN
• 不依賴jQuery

---

安裝

npm安裝

$ npm install sortablejs --save

bower安裝

$ bower install --save sortablejs

固然還有直接引入

<script src="../../js/Sortable.min.js"></script>

---

使用

<ul id="items">
    <li>item 1</li>
    <li>item 2</li>
    <li>item 3</li>
</ul>

能夠經過Sorable對象中的create方法建立

var el = document.getElementById('items');
var sortable = Sortable.create(el,{});

也能夠經過新建個Sortable對象來建立

var sortable = new Sortable(el, {})

實例中dom結構中用到的是ul（無序列表），固然也能夠用其餘的元素來構造例如使用div等

---

配置項

先把他的總體配置寫出來，在一個個介紹

var sortable = new Sortable(el, {
    group: "name",  // or { name: "...", pull: [true, false, clone], put: [true, false, array] }
    sort: true,  // sorting inside list
    delay: 0, // time in milliseconds to define when the sorting should start
    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
    handle: ".my-handle",  // Drag handle selector within list items
    filter: ".ignore-elements",  // Selectors that do not lead to dragging (String or Function)
    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',

    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) { ... }, // 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

    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 dragging started
    onStart: function (/**Event*/evt) {
        evt.oldIndex;  // element index within parent
    },

    // Element dragging ended
    onEnd: function (/**Event*/evt) {
        evt.oldIndex;  // element's old index within parent
        evt.newIndex;  // element's new index within parent
    },

    // Element is dropped into the list from another list
    onAdd: function (/**Event*/evt) {
        var itemEl = evt.item;  // dragged HTMLElement
        evt.from;  // previous list
        // + indexes from onEnd
    },

    // Changed sorting within list
    onUpdate: function (/**Event*/evt) {
        var itemEl = evt.item;  // dragged HTMLElement
        // + indexes from onEnd
    },

    // Called by any change to the list (add / update / remove)
    onSort: function (/**Event*/evt) {
        // same properties as onUpdate
    },

    // Element is removed from the list into another list
    onRemove: function (/**Event*/evt) {
        // same properties as onUpdate
    },

    // 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: http://jsbin.com/tuyafe/1/edit?js,output
        evt.dragged; // dragged HTMLElement
        evt.draggedRect; // TextRectangle {left, top, right и bottom}
        evt.related; // HTMLElement on which have guided
        evt.relatedRect; // TextRectangle
        originalEvent.clientY; // mouse position
        // return false; — for cancel
    },

    // Called when creating a clone of element
    onClone: function (/**Event*/evt) {
        var origEl = evt.item;
        var cloneEl = evt.clone;
    }
});

屬性：

• group：string or object

  string：命名，我的建議用元素id就行,用處是爲了設置能夠拖放容器時使用，在array中的put的設置中再作介紹；
         object：{name,pull,put}
                 name：同string的方法，
                 pull：pull用來定義從這個列表容器移動出去的設置，true/false/'clone'/function
                     true:列表容器內的列表單元能夠被移出；
                     false：列表容器內的列表單元不能夠被移出；
                     'clone'：列表單元移出，移動的爲該元素的副本；
                     function：用來進行pull的函數判斷，能夠進行復雜邏輯，在函數中return false/true來判斷是否移出；
                 put：put用來定義往這個列表容器放置列表單元的的設置，true/false/['foo','bar']/function
                     true:列表容器能夠從其餘列表容器內放入列表單元；
                     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 當建立一個列表單元副本的時候的回調函數

事件對象：
事件對象在各個函數中略有不一樣，可經過輸出對象查看對象的屬性，下面簡單列舉幾個：

• to：HTMLElement--移動到列表容器
• from：HTMLElement--來源的列表容器
• item：HTMLElement--被移動的列表單元
• clone：HTMLElement--副本的列表單元
• oldIndex：number/undefined--在列表容器中的原序號
• newIndex：number/undefined--在列表容器中的新序號

---

方法

• option(name[,value])
  得到或者設置項參數，使用方法相似於jQuery用法，沒有第二個參數爲得到option中第一個參數所對應的值，有第二個參數時，將從新賦給第一個參數所對應的值；
• closest
  沒理解
• toArray()
  序列化可排序的列表單元的data-id（可經過配置項中dataIdAttr修改）放入一個數組，並返回這個數組中
• sort()
  經過自定義列表單元的data-id的數組對列表單元進行排序
• save()
• destroy()

有問題加我qq吧，這個評論翻着不是很好找，635905156