/dragsort

Primary LanguageHTML

jQuery List DragSort

This is simple sortable (drag and drop) library. It works with latest jQuery version and mobile/touch devices Supports bower and npm

Demo

Latest changes

  • Support touch events
  • Support latest jQuery version
  • Add new option cursor which can change default cursor from "pointer" to "move" for example
  • Optimize the code
  • Create bower and npm packages

Usage

$('ul').dragsort({
    dragSelector: 'li',
    dragEnd: function() {
        console.log('Drag End');
    }, dragBetween: false,
    placeHolderTemplate: '<li></li>'
}); 

// $('ul').dragsort('destroy');
  • dragSelector: The CSS selector of the element inside the list item to act as the drag handle. The default is the list item itself e.g. LI.
  • dragSelectorExclude: The css selector of the elements inside the dragSelector to not trigger dragsort. The default is "input, textarea".
  • itemSelector: The css selector of the list items that are moveable. Will only match elements that are immediate children of list container. The default is tag name of first child e.g. LI.
  • dragEnd: The callback function that will be called after the dragging has ended (only called if the list order has changed). The keyword "this" in function will refer to list item that was dragged.
  • dragBetween: Set to "true" if you want to enable the ability to drag between selected lists or to allow dragging of the list item outside of the list for auto scroll. The default is false.
  • placeHolderTemplate: The html of the place holder for the dragged item. The default is empty list item e.g. "<li></li>".
  • scrollContainer: The css selector of the element you want to scroll (i.e. div with overflow set to auto) when the list item is dragged outside the list. The default is window.
  • scrollSpeed: A number that represents the speed that the page will scroll when dragging an item outside the scroll container, a higher value is faster and a lower value is slower. Set to 0 to disable scrolling. The default is 5.
  • cursor: The CSS cursor when the item is dragged

Install

Dependencies

bower

$ bower install dragsort

npm

$ npm install dragsort