2 * jQuery UI Sortable 1.10.3
5 * Copyright 2013 jQuery Foundation and other contributors
6 * Released under the MIT license.
7 * http://jquery.org/license
9 * http://api.jqueryui.com/sortable/
16 (function( $, undefined ) {
18 /*jshint loopfunc: true */
20 function isOverAxis( x, reference, size ) {
21 return ( x > reference ) && ( x < ( reference + size ) );
24 function isFloating(item) {
25 return (/left|right/).test(item.css("float")) || (/inline|table-cell/).test(item.css("display"));
28 $.widget("ui.sortable", $.ui.mouse, {
30 widgetEventPrefix: "sort",
40 forcePlaceholderSize: false,
41 forceHelperSize: false,
50 scrollSensitivity: 20,
53 tolerance: "intersect",
73 this.containerCache = {};
74 this.element.addClass("ui-sortable");
79 //Let's determine if the items are being displayed horizontally
80 this.floating = this.items.length ? o.axis === "x" || isFloating(this.items[0].item) : false;
82 //Let's determine the parent's offset
83 this.offset = this.element.offset();
85 //Initialize mouse events for interaction
93 _destroy: function() {
95 .removeClass("ui-sortable ui-sortable-disabled");
98 for ( var i = this.items.length - 1; i >= 0; i-- ) {
99 this.items[i].item.removeData(this.widgetName + "-item");
105 _setOption: function(key, value){
106 if ( key === "disabled" ) {
107 this.options[ key ] = value;
109 this.widget().toggleClass( "ui-sortable-disabled", !!value );
111 // Don't call widget base _setOption for disable as it adds ui-state-disabled class
112 $.Widget.prototype._setOption.apply(this, arguments);
116 _mouseCapture: function(event, overrideHandle) {
117 var currentItem = null,
121 if (this.reverting) {
125 if(this.options.disabled || this.options.type === "static") {
129 //We have to refresh the items data once first
130 this._refreshItems(event);
132 //Find out if the clicked node (or one of its parents) is a actual item in this.items
133 $(event.target).parents().each(function() {
134 if($.data(this, that.widgetName + "-item") === that) {
135 currentItem = $(this);
139 if($.data(event.target, that.widgetName + "-item") === that) {
140 currentItem = $(event.target);
146 if(this.options.handle && !overrideHandle) {
147 $(this.options.handle, currentItem).find("*").addBack().each(function() {
148 if(this === event.target) {
157 this.currentItem = currentItem;
158 this._removeCurrentsFromItems();
163 _mouseStart: function(event, overrideHandle, noActivation) {
168 this.currentContainer = this;
170 //We only need to call refreshPositions, because the refreshItems call has been moved to mouseCapture
171 this.refreshPositions();
173 //Create and append the visible helper
174 this.helper = this._createHelper(event);
176 //Cache the helper size
177 this._cacheHelperProportions();
180 * - Position generation -
181 * This block generates everything position related - it's the core of draggables.
184 //Cache the margins of the original element
185 this._cacheMargins();
187 //Get the next scrolling parent
188 this.scrollParent = this.helper.scrollParent();
190 //The element's absolute position on the page minus margins
191 this.offset = this.currentItem.offset();
193 top: this.offset.top - this.margins.top,
194 left: this.offset.left - this.margins.left
197 $.extend(this.offset, {
198 click: { //Where the click happened, relative to the element
199 left: event.pageX - this.offset.left,
200 top: event.pageY - this.offset.top
202 parent: this._getParentOffset(),
203 relative: this._getRelativeOffset() //This is a relative to absolute position minus the actual position calculation - only used for relative positioned helper
206 // Only after we got the offset, we can change the helper's position to absolute
207 // TODO: Still need to figure out a way to make relative sorting possible
208 this.helper.css("position", "absolute");
209 this.cssPosition = this.helper.css("position");
211 //Generate the original position
212 this.originalPosition = this._generatePosition(event);
213 this.originalPageX = event.pageX;
214 this.originalPageY = event.pageY;
216 //Adjust the mouse offset relative to the helper if "cursorAt" is supplied
217 (o.cursorAt && this._adjustOffsetFromHelper(o.cursorAt));
219 //Cache the former DOM position
220 this.domPosition = { prev: this.currentItem.prev()[0], parent: this.currentItem.parent()[0] };
222 //If the helper is not the original, hide the original so it's not playing any role during the drag, won't cause anything bad this way
223 if(this.helper[0] !== this.currentItem[0]) {
224 this.currentItem.hide();
227 //Create the placeholder
228 this._createPlaceholder();
230 //Set a containment if given in the options
232 this._setContainment();
235 if( o.cursor && o.cursor !== "auto" ) { // cursor option
236 body = this.document.find( "body" );
239 this.storedCursor = body.css( "cursor" );
240 body.css( "cursor", o.cursor );
242 this.storedStylesheet = $( "<style>*{ cursor: "+o.cursor+" !important; }</style>" ).appendTo( body );
245 if(o.opacity) { // opacity option
246 if (this.helper.css("opacity")) {
247 this._storedOpacity = this.helper.css("opacity");
249 this.helper.css("opacity", o.opacity);
252 if(o.zIndex) { // zIndex option
253 if (this.helper.css("zIndex")) {
254 this._storedZIndex = this.helper.css("zIndex");
256 this.helper.css("zIndex", o.zIndex);
260 if(this.scrollParent[0] !== document && this.scrollParent[0].tagName !== "HTML") {
261 this.overflowOffset = this.scrollParent.offset();
265 this._trigger("start", event, this._uiHash());
267 //Recache the helper size
268 if(!this._preserveHelperProportions) {
269 this._cacheHelperProportions();
273 //Post "activate" events to possible containers
274 if( !noActivation ) {
275 for ( i = this.containers.length - 1; i >= 0; i-- ) {
276 this.containers[ i ]._trigger( "activate", event, this._uiHash( this ) );
280 //Prepare possible droppables
282 $.ui.ddmanager.current = this;
285 if ($.ui.ddmanager && !o.dropBehaviour) {
286 $.ui.ddmanager.prepareOffsets(this, event);
289 this.dragging = true;
291 this.helper.addClass("ui-sortable-helper");
292 this._mouseDrag(event); //Execute the drag once - this causes the helper not to be visible before getting its correct position
297 _mouseDrag: function(event) {
298 var i, item, itemElement, intersection,
302 //Compute the helpers position
303 this.position = this._generatePosition(event);
304 this.positionAbs = this._convertPositionTo("absolute");
306 if (!this.lastPositionAbs) {
307 this.lastPositionAbs = this.positionAbs;
311 if(this.options.scroll) {
312 if(this.scrollParent[0] !== document && this.scrollParent[0].tagName !== "HTML") {
314 if((this.overflowOffset.top + this.scrollParent[0].offsetHeight) - event.pageY < o.scrollSensitivity) {
315 this.scrollParent[0].scrollTop = scrolled = this.scrollParent[0].scrollTop + o.scrollSpeed;
316 } else if(event.pageY - this.overflowOffset.top < o.scrollSensitivity) {
317 this.scrollParent[0].scrollTop = scrolled = this.scrollParent[0].scrollTop - o.scrollSpeed;
320 if((this.overflowOffset.left + this.scrollParent[0].offsetWidth) - event.pageX < o.scrollSensitivity) {
321 this.scrollParent[0].scrollLeft = scrolled = this.scrollParent[0].scrollLeft + o.scrollSpeed;
322 } else if(event.pageX - this.overflowOffset.left < o.scrollSensitivity) {
323 this.scrollParent[0].scrollLeft = scrolled = this.scrollParent[0].scrollLeft - o.scrollSpeed;
328 if(event.pageY - $(document).scrollTop() < o.scrollSensitivity) {
329 scrolled = $(document).scrollTop($(document).scrollTop() - o.scrollSpeed);
330 } else if($(window).height() - (event.pageY - $(document).scrollTop()) < o.scrollSensitivity) {
331 scrolled = $(document).scrollTop($(document).scrollTop() + o.scrollSpeed);
334 if(event.pageX - $(document).scrollLeft() < o.scrollSensitivity) {
335 scrolled = $(document).scrollLeft($(document).scrollLeft() - o.scrollSpeed);
336 } else if($(window).width() - (event.pageX - $(document).scrollLeft()) < o.scrollSensitivity) {
337 scrolled = $(document).scrollLeft($(document).scrollLeft() + o.scrollSpeed);
342 if(scrolled !== false && $.ui.ddmanager && !o.dropBehaviour) {
343 $.ui.ddmanager.prepareOffsets(this, event);
347 //Regenerate the absolute position used for position checks
348 this.positionAbs = this._convertPositionTo("absolute");
350 //Set the helper position
351 if(!this.options.axis || this.options.axis !== "y") {
352 this.helper[0].style.left = this.position.left+"px";
354 if(!this.options.axis || this.options.axis !== "x") {
355 this.helper[0].style.top = this.position.top+"px";
359 for (i = this.items.length - 1; i >= 0; i--) {
361 //Cache variables and intersection, continue if no intersection
362 item = this.items[i];
363 itemElement = item.item[0];
364 intersection = this._intersectsWithPointer(item);
369 // Only put the placeholder inside the current Container, skip all
370 // items form other containers. This works because when moving
371 // an item from one container to another the
372 // currentContainer is switched before the placeholder is moved.
374 // Without this moving items in "sub-sortables" can cause the placeholder to jitter
375 // beetween the outer and inner container.
376 if (item.instance !== this.currentContainer) {
380 // cannot intersect with itself
381 // no useless actions that have been done before
382 // no action if the item moved is the parent of the item checked
383 if (itemElement !== this.currentItem[0] &&
384 this.placeholder[intersection === 1 ? "next" : "prev"]()[0] !== itemElement &&
385 !$.contains(this.placeholder[0], itemElement) &&
386 (this.options.type === "semi-dynamic" ? !$.contains(this.element[0], itemElement) : true)
389 this.direction = intersection === 1 ? "down" : "up";
391 if (this.options.tolerance === "pointer" || this._intersectsWithSides(item)) {
392 this._rearrange(event, item);
397 this._trigger("change", event, this._uiHash());
402 //Post events to containers
403 this._contactContainers(event);
405 //Interconnect with droppables
407 $.ui.ddmanager.drag(this, event);
411 this._trigger("sort", event, this._uiHash());
413 this.lastPositionAbs = this.positionAbs;
418 _mouseStop: function(event, noPropagation) {
424 //If we are using droppables, inform the manager about the drop
425 if ($.ui.ddmanager && !this.options.dropBehaviour) {
426 $.ui.ddmanager.drop(this, event);
429 if(this.options.revert) {
431 cur = this.placeholder.offset(),
432 axis = this.options.axis,
435 if ( !axis || axis === "x" ) {
436 animation.left = cur.left - this.offset.parent.left - this.margins.left + (this.offsetParent[0] === document.body ? 0 : this.offsetParent[0].scrollLeft);
438 if ( !axis || axis === "y" ) {
439 animation.top = cur.top - this.offset.parent.top - this.margins.top + (this.offsetParent[0] === document.body ? 0 : this.offsetParent[0].scrollTop);
441 this.reverting = true;
442 $(this.helper).animate( animation, parseInt(this.options.revert, 10) || 500, function() {
446 this._clear(event, noPropagation);
457 this._mouseUp({ target: null });
459 if(this.options.helper === "original") {
460 this.currentItem.css(this._storedCSS).removeClass("ui-sortable-helper");
462 this.currentItem.show();
465 //Post deactivating events to containers
466 for (var i = this.containers.length - 1; i >= 0; i--){
467 this.containers[i]._trigger("deactivate", null, this._uiHash(this));
468 if(this.containers[i].containerCache.over) {
469 this.containers[i]._trigger("out", null, this._uiHash(this));
470 this.containers[i].containerCache.over = 0;
476 if (this.placeholder) {
477 //$(this.placeholder[0]).remove(); would have been the jQuery way - unfortunately, it unbinds ALL events from the original node!
478 if(this.placeholder[0].parentNode) {
479 this.placeholder[0].parentNode.removeChild(this.placeholder[0]);
481 if(this.options.helper !== "original" && this.helper && this.helper[0].parentNode) {
482 this.helper.remove();
492 if(this.domPosition.prev) {
493 $(this.domPosition.prev).after(this.currentItem);
495 $(this.domPosition.parent).prepend(this.currentItem);
503 serialize: function(o) {
505 var items = this._getItemsAsjQuery(o && o.connected),
509 $(items).each(function() {
510 var res = ($(o.item || this).attr(o.attribute || "id") || "").match(o.expression || (/(.+)[\-=_](.+)/));
512 str.push((o.key || res[1]+"[]")+"="+(o.key && o.expression ? res[1] : res[2]));
516 if(!str.length && o.key) {
517 str.push(o.key + "=");
520 return str.join("&");
524 toArray: function(o) {
526 var items = this._getItemsAsjQuery(o && o.connected),
531 items.each(function() { ret.push($(o.item || this).attr(o.attribute || "id") || ""); });
536 /* Be careful with the following core functions */
537 _intersectsWith: function(item) {
539 var x1 = this.positionAbs.left,
540 x2 = x1 + this.helperProportions.width,
541 y1 = this.positionAbs.top,
542 y2 = y1 + this.helperProportions.height,
547 dyClick = this.offset.click.top,
548 dxClick = this.offset.click.left,
549 isOverElementHeight = ( this.options.axis === "x" ) || ( ( y1 + dyClick ) > t && ( y1 + dyClick ) < b ),
550 isOverElementWidth = ( this.options.axis === "y" ) || ( ( x1 + dxClick ) > l && ( x1 + dxClick ) < r ),
551 isOverElement = isOverElementHeight && isOverElementWidth;
553 if ( this.options.tolerance === "pointer" ||
554 this.options.forcePointerForContainers ||
555 (this.options.tolerance !== "pointer" && this.helperProportions[this.floating ? "width" : "height"] > item[this.floating ? "width" : "height"])
557 return isOverElement;
560 return (l < x1 + (this.helperProportions.width / 2) && // Right Half
561 x2 - (this.helperProportions.width / 2) < r && // Left Half
562 t < y1 + (this.helperProportions.height / 2) && // Bottom Half
563 y2 - (this.helperProportions.height / 2) < b ); // Top Half
568 _intersectsWithPointer: function(item) {
570 var isOverElementHeight = (this.options.axis === "x") || isOverAxis(this.positionAbs.top + this.offset.click.top, item.top, item.height),
571 isOverElementWidth = (this.options.axis === "y") || isOverAxis(this.positionAbs.left + this.offset.click.left, item.left, item.width),
572 isOverElement = isOverElementHeight && isOverElementWidth,
573 verticalDirection = this._getDragVerticalDirection(),
574 horizontalDirection = this._getDragHorizontalDirection();
576 if (!isOverElement) {
580 return this.floating ?
581 ( ((horizontalDirection && horizontalDirection === "right") || verticalDirection === "down") ? 2 : 1 )
582 : ( verticalDirection && (verticalDirection === "down" ? 2 : 1) );
586 _intersectsWithSides: function(item) {
588 var isOverBottomHalf = isOverAxis(this.positionAbs.top + this.offset.click.top, item.top + (item.height/2), item.height),
589 isOverRightHalf = isOverAxis(this.positionAbs.left + this.offset.click.left, item.left + (item.width/2), item.width),
590 verticalDirection = this._getDragVerticalDirection(),
591 horizontalDirection = this._getDragHorizontalDirection();
593 if (this.floating && horizontalDirection) {
594 return ((horizontalDirection === "right" && isOverRightHalf) || (horizontalDirection === "left" && !isOverRightHalf));
596 return verticalDirection && ((verticalDirection === "down" && isOverBottomHalf) || (verticalDirection === "up" && !isOverBottomHalf));
601 _getDragVerticalDirection: function() {
602 var delta = this.positionAbs.top - this.lastPositionAbs.top;
603 return delta !== 0 && (delta > 0 ? "down" : "up");
606 _getDragHorizontalDirection: function() {
607 var delta = this.positionAbs.left - this.lastPositionAbs.left;
608 return delta !== 0 && (delta > 0 ? "right" : "left");
611 refresh: function(event) {
612 this._refreshItems(event);
613 this.refreshPositions();
617 _connectWith: function() {
618 var options = this.options;
619 return options.connectWith.constructor === String ? [options.connectWith] : options.connectWith;
622 _getItemsAsjQuery: function(connected) {
627 connectWith = this._connectWith();
629 if(connectWith && connected) {
630 for (i = connectWith.length - 1; i >= 0; i--){
631 cur = $(connectWith[i]);
632 for ( j = cur.length - 1; j >= 0; j--){
633 inst = $.data(cur[j], this.widgetFullName);
634 if(inst && inst !== this && !inst.options.disabled) {
635 queries.push([$.isFunction(inst.options.items) ? inst.options.items.call(inst.element) : $(inst.options.items, inst.element).not(".ui-sortable-helper").not(".ui-sortable-placeholder"), inst]);
641 queries.push([$.isFunction(this.options.items) ? this.options.items.call(this.element, null, { options: this.options, item: this.currentItem }) : $(this.options.items, this.element).not(".ui-sortable-helper").not(".ui-sortable-placeholder"), this]);
643 for (i = queries.length - 1; i >= 0; i--){
644 queries[i][0].each(function() {
653 _removeCurrentsFromItems: function() {
655 var list = this.currentItem.find(":data(" + this.widgetName + "-item)");
657 this.items = $.grep(this.items, function (item) {
658 for (var j=0; j < list.length; j++) {
659 if(list[j] === item.item[0]) {
668 _refreshItems: function(event) {
671 this.containers = [this];
673 var i, j, cur, inst, targetData, _queries, item, queriesLength,
675 queries = [[$.isFunction(this.options.items) ? this.options.items.call(this.element[0], event, { item: this.currentItem }) : $(this.options.items, this.element), this]],
676 connectWith = this._connectWith();
678 if(connectWith && this.ready) { //Shouldn't be run the first time through due to massive slow-down
679 for (i = connectWith.length - 1; i >= 0; i--){
680 cur = $(connectWith[i]);
681 for (j = cur.length - 1; j >= 0; j--){
682 inst = $.data(cur[j], this.widgetFullName);
683 if(inst && inst !== this && !inst.options.disabled) {
684 queries.push([$.isFunction(inst.options.items) ? inst.options.items.call(inst.element[0], event, { item: this.currentItem }) : $(inst.options.items, inst.element), inst]);
685 this.containers.push(inst);
691 for (i = queries.length - 1; i >= 0; i--) {
692 targetData = queries[i][1];
693 _queries = queries[i][0];
695 for (j=0, queriesLength = _queries.length; j < queriesLength; j++) {
696 item = $(_queries[j]);
698 item.data(this.widgetName + "-item", targetData); // Data for target checking (mouse manager)
702 instance: targetData,
711 refreshPositions: function(fast) {
713 //This has to be redone because due to the item being moved out/into the offsetParent, the offsetParent's position will change
714 if(this.offsetParent && this.helper) {
715 this.offset.parent = this._getParentOffset();
720 for (i = this.items.length - 1; i >= 0; i--){
721 item = this.items[i];
723 //We ignore calculating positions of all connected containers when we're not over them
724 if(item.instance !== this.currentContainer && this.currentContainer && item.item[0] !== this.currentItem[0]) {
728 t = this.options.toleranceElement ? $(this.options.toleranceElement, item.item) : item.item;
731 item.width = t.outerWidth();
732 item.height = t.outerHeight();
740 if(this.options.custom && this.options.custom.refreshContainers) {
741 this.options.custom.refreshContainers.call(this);
743 for (i = this.containers.length - 1; i >= 0; i--){
744 p = this.containers[i].element.offset();
745 this.containers[i].containerCache.left = p.left;
746 this.containers[i].containerCache.top = p.top;
747 this.containers[i].containerCache.width = this.containers[i].element.outerWidth();
748 this.containers[i].containerCache.height = this.containers[i].element.outerHeight();
755 _createPlaceholder: function(that) {
760 if(!o.placeholder || o.placeholder.constructor === String) {
761 className = o.placeholder;
763 element: function() {
765 var nodeName = that.currentItem[0].nodeName.toLowerCase(),
766 element = $( "<" + nodeName + ">", that.document[0] )
767 .addClass(className || that.currentItem[0].className+" ui-sortable-placeholder")
768 .removeClass("ui-sortable-helper");
770 if ( nodeName === "tr" ) {
771 that.currentItem.children().each(function() {
772 $( "<td> </td>", that.document[0] )
773 .attr( "colspan", $( this ).attr( "colspan" ) || 1 )
774 .appendTo( element );
776 } else if ( nodeName === "img" ) {
777 element.attr( "src", that.currentItem.attr( "src" ) );
781 element.css( "visibility", "hidden" );
786 update: function(container, p) {
788 // 1. If a className is set as 'placeholder option, we don't force sizes - the class is responsible for that
789 // 2. The option 'forcePlaceholderSize can be enabled to force it even if a class name is specified
790 if(className && !o.forcePlaceholderSize) {
794 //If the element doesn't have a actual height by itself (without styles coming from a stylesheet), it receives the inline height from the dragged item
795 if(!p.height()) { p.height(that.currentItem.innerHeight() - parseInt(that.currentItem.css("paddingTop")||0, 10) - parseInt(that.currentItem.css("paddingBottom")||0, 10)); }
796 if(!p.width()) { p.width(that.currentItem.innerWidth() - parseInt(that.currentItem.css("paddingLeft")||0, 10) - parseInt(that.currentItem.css("paddingRight")||0, 10)); }
801 //Create the placeholder
802 that.placeholder = $(o.placeholder.element.call(that.element, that.currentItem));
804 //Append it after the actual current item
805 that.currentItem.after(that.placeholder);
807 //Update the size of the placeholder (TODO: Logic to fuzzy, see line 316/317)
808 o.placeholder.update(that, that.placeholder);
812 _contactContainers: function(event) {
813 var i, j, dist, itemWithLeastDistance, posProperty, sizeProperty, base, cur, nearBottom, floating,
814 innermostContainer = null,
815 innermostIndex = null;
817 // get innermost container that intersects with item
818 for (i = this.containers.length - 1; i >= 0; i--) {
820 // never consider a container that's located within the item itself
821 if($.contains(this.currentItem[0], this.containers[i].element[0])) {
825 if(this._intersectsWith(this.containers[i].containerCache)) {
827 // if we've already found a container and it's more "inner" than this, then continue
828 if(innermostContainer && $.contains(this.containers[i].element[0], innermostContainer.element[0])) {
832 innermostContainer = this.containers[i];
836 // container doesn't intersect. trigger "out" event if necessary
837 if(this.containers[i].containerCache.over) {
838 this.containers[i]._trigger("out", event, this._uiHash(this));
839 this.containers[i].containerCache.over = 0;
845 // if no intersecting containers found, return
846 if(!innermostContainer) {
850 // move the item into the container if it's not there already
851 if(this.containers.length === 1) {
852 if (!this.containers[innermostIndex].containerCache.over) {
853 this.containers[innermostIndex]._trigger("over", event, this._uiHash(this));
854 this.containers[innermostIndex].containerCache.over = 1;
858 //When entering a new container, we will find the item with the least distance and append our item near it
860 itemWithLeastDistance = null;
861 floating = innermostContainer.floating || isFloating(this.currentItem);
862 posProperty = floating ? "left" : "top";
863 sizeProperty = floating ? "width" : "height";
864 base = this.positionAbs[posProperty] + this.offset.click[posProperty];
865 for (j = this.items.length - 1; j >= 0; j--) {
866 if(!$.contains(this.containers[innermostIndex].element[0], this.items[j].item[0])) {
869 if(this.items[j].item[0] === this.currentItem[0]) {
872 if (floating && !isOverAxis(this.positionAbs.top + this.offset.click.top, this.items[j].top, this.items[j].height)) {
875 cur = this.items[j].item.offset()[posProperty];
877 if(Math.abs(cur - base) > Math.abs(cur + this.items[j][sizeProperty] - base)){
879 cur += this.items[j][sizeProperty];
882 if(Math.abs(cur - base) < dist) {
883 dist = Math.abs(cur - base); itemWithLeastDistance = this.items[j];
884 this.direction = nearBottom ? "up": "down";
888 //Check if dropOnEmpty is enabled
889 if(!itemWithLeastDistance && !this.options.dropOnEmpty) {
893 if(this.currentContainer === this.containers[innermostIndex]) {
897 itemWithLeastDistance ? this._rearrange(event, itemWithLeastDistance, null, true) : this._rearrange(event, null, this.containers[innermostIndex].element, true);
898 this._trigger("change", event, this._uiHash());
899 this.containers[innermostIndex]._trigger("change", event, this._uiHash(this));
900 this.currentContainer = this.containers[innermostIndex];
902 //Update the placeholder
903 this.options.placeholder.update(this.currentContainer, this.placeholder);
905 this.containers[innermostIndex]._trigger("over", event, this._uiHash(this));
906 this.containers[innermostIndex].containerCache.over = 1;
912 _createHelper: function(event) {
914 var o = this.options,
915 helper = $.isFunction(o.helper) ? $(o.helper.apply(this.element[0], [event, this.currentItem])) : (o.helper === "clone" ? this.currentItem.clone() : this.currentItem);
917 //Add the helper to the DOM if that didn't happen already
918 if(!helper.parents("body").length) {
919 $(o.appendTo !== "parent" ? o.appendTo : this.currentItem[0].parentNode)[0].appendChild(helper[0]);
922 if(helper[0] === this.currentItem[0]) {
923 this._storedCSS = { width: this.currentItem[0].style.width, height: this.currentItem[0].style.height, position: this.currentItem.css("position"), top: this.currentItem.css("top"), left: this.currentItem.css("left") };
926 if(!helper[0].style.width || o.forceHelperSize) {
927 helper.width(this.currentItem.width());
929 if(!helper[0].style.height || o.forceHelperSize) {
930 helper.height(this.currentItem.height());
937 _adjustOffsetFromHelper: function(obj) {
938 if (typeof obj === "string") {
939 obj = obj.split(" ");
941 if ($.isArray(obj)) {
942 obj = {left: +obj[0], top: +obj[1] || 0};
945 this.offset.click.left = obj.left + this.margins.left;
947 if ("right" in obj) {
948 this.offset.click.left = this.helperProportions.width - obj.right + this.margins.left;
951 this.offset.click.top = obj.top + this.margins.top;
953 if ("bottom" in obj) {
954 this.offset.click.top = this.helperProportions.height - obj.bottom + this.margins.top;
958 _getParentOffset: function() {
961 //Get the offsetParent and cache its position
962 this.offsetParent = this.helper.offsetParent();
963 var po = this.offsetParent.offset();
965 // This is a special case where we need to modify a offset calculated on start, since the following happened:
966 // 1. The position of the helper is absolute, so it's position is calculated based on the next positioned parent
967 // 2. The actual offset parent is a child of the scroll parent, and the scroll parent isn't the document, which means that
968 // the scroll is included in the initial calculation of the offset of the parent, and never recalculated upon drag
969 if(this.cssPosition === "absolute" && this.scrollParent[0] !== document && $.contains(this.scrollParent[0], this.offsetParent[0])) {
970 po.left += this.scrollParent.scrollLeft();
971 po.top += this.scrollParent.scrollTop();
974 // This needs to be actually done for all browsers, since pageX/pageY includes this information
975 // with an ugly IE fix
976 if( this.offsetParent[0] === document.body || (this.offsetParent[0].tagName && this.offsetParent[0].tagName.toLowerCase() === "html" && $.ui.ie)) {
977 po = { top: 0, left: 0 };
981 top: po.top + (parseInt(this.offsetParent.css("borderTopWidth"),10) || 0),
982 left: po.left + (parseInt(this.offsetParent.css("borderLeftWidth"),10) || 0)
987 _getRelativeOffset: function() {
989 if(this.cssPosition === "relative") {
990 var p = this.currentItem.position();
992 top: p.top - (parseInt(this.helper.css("top"),10) || 0) + this.scrollParent.scrollTop(),
993 left: p.left - (parseInt(this.helper.css("left"),10) || 0) + this.scrollParent.scrollLeft()
996 return { top: 0, left: 0 };
1001 _cacheMargins: function() {
1003 left: (parseInt(this.currentItem.css("marginLeft"),10) || 0),
1004 top: (parseInt(this.currentItem.css("marginTop"),10) || 0)
1008 _cacheHelperProportions: function() {
1009 this.helperProportions = {
1010 width: this.helper.outerWidth(),
1011 height: this.helper.outerHeight()
1015 _setContainment: function() {
1019 if(o.containment === "parent") {
1020 o.containment = this.helper[0].parentNode;
1022 if(o.containment === "document" || o.containment === "window") {
1023 this.containment = [
1024 0 - this.offset.relative.left - this.offset.parent.left,
1025 0 - this.offset.relative.top - this.offset.parent.top,
1026 $(o.containment === "document" ? document : window).width() - this.helperProportions.width - this.margins.left,
1027 ($(o.containment === "document" ? document : window).height() || document.body.parentNode.scrollHeight) - this.helperProportions.height - this.margins.top
1031 if(!(/^(document|window|parent)$/).test(o.containment)) {
1032 ce = $(o.containment)[0];
1033 co = $(o.containment).offset();
1034 over = ($(ce).css("overflow") !== "hidden");
1036 this.containment = [
1037 co.left + (parseInt($(ce).css("borderLeftWidth"),10) || 0) + (parseInt($(ce).css("paddingLeft"),10) || 0) - this.margins.left,
1038 co.top + (parseInt($(ce).css("borderTopWidth"),10) || 0) + (parseInt($(ce).css("paddingTop"),10) || 0) - this.margins.top,
1039 co.left+(over ? Math.max(ce.scrollWidth,ce.offsetWidth) : ce.offsetWidth) - (parseInt($(ce).css("borderLeftWidth"),10) || 0) - (parseInt($(ce).css("paddingRight"),10) || 0) - this.helperProportions.width - this.margins.left,
1040 co.top+(over ? Math.max(ce.scrollHeight,ce.offsetHeight) : ce.offsetHeight) - (parseInt($(ce).css("borderTopWidth"),10) || 0) - (parseInt($(ce).css("paddingBottom"),10) || 0) - this.helperProportions.height - this.margins.top
1046 _convertPositionTo: function(d, pos) {
1049 pos = this.position;
1051 var mod = d === "absolute" ? 1 : -1,
1052 scroll = this.cssPosition === "absolute" && !(this.scrollParent[0] !== document && $.contains(this.scrollParent[0], this.offsetParent[0])) ? this.offsetParent : this.scrollParent,
1053 scrollIsRootNode = (/(html|body)/i).test(scroll[0].tagName);
1057 pos.top + // The absolute mouse position
1058 this.offset.relative.top * mod + // Only for relative positioned nodes: Relative offset from element to offset parent
1059 this.offset.parent.top * mod - // The offsetParent's offset without borders (offset + border)
1060 ( ( this.cssPosition === "fixed" ? -this.scrollParent.scrollTop() : ( scrollIsRootNode ? 0 : scroll.scrollTop() ) ) * mod)
1063 pos.left + // The absolute mouse position
1064 this.offset.relative.left * mod + // Only for relative positioned nodes: Relative offset from element to offset parent
1065 this.offset.parent.left * mod - // The offsetParent's offset without borders (offset + border)
1066 ( ( this.cssPosition === "fixed" ? -this.scrollParent.scrollLeft() : scrollIsRootNode ? 0 : scroll.scrollLeft() ) * mod)
1072 _generatePosition: function(event) {
1076 pageX = event.pageX,
1077 pageY = event.pageY,
1078 scroll = this.cssPosition === "absolute" && !(this.scrollParent[0] !== document && $.contains(this.scrollParent[0], this.offsetParent[0])) ? this.offsetParent : this.scrollParent, scrollIsRootNode = (/(html|body)/i).test(scroll[0].tagName);
1080 // This is another very weird special case that only happens for relative elements:
1081 // 1. If the css position is relative
1082 // 2. and the scroll parent is the document or similar to the offset parent
1083 // we have to refresh the relative offset during the scroll so there are no jumps
1084 if(this.cssPosition === "relative" && !(this.scrollParent[0] !== document && this.scrollParent[0] !== this.offsetParent[0])) {
1085 this.offset.relative = this._getRelativeOffset();
1089 * - Position constraining -
1090 * Constrain the position to a mix of grid, containment.
1093 if(this.originalPosition) { //If we are not dragging yet, we won't check for options
1095 if(this.containment) {
1096 if(event.pageX - this.offset.click.left < this.containment[0]) {
1097 pageX = this.containment[0] + this.offset.click.left;
1099 if(event.pageY - this.offset.click.top < this.containment[1]) {
1100 pageY = this.containment[1] + this.offset.click.top;
1102 if(event.pageX - this.offset.click.left > this.containment[2]) {
1103 pageX = this.containment[2] + this.offset.click.left;
1105 if(event.pageY - this.offset.click.top > this.containment[3]) {
1106 pageY = this.containment[3] + this.offset.click.top;
1111 top = this.originalPageY + Math.round((pageY - this.originalPageY) / o.grid[1]) * o.grid[1];
1112 pageY = this.containment ? ( (top - this.offset.click.top >= this.containment[1] && top - this.offset.click.top <= this.containment[3]) ? top : ((top - this.offset.click.top >= this.containment[1]) ? top - o.grid[1] : top + o.grid[1])) : top;
1114 left = this.originalPageX + Math.round((pageX - this.originalPageX) / o.grid[0]) * o.grid[0];
1115 pageX = this.containment ? ( (left - this.offset.click.left >= this.containment[0] && left - this.offset.click.left <= this.containment[2]) ? left : ((left - this.offset.click.left >= this.containment[0]) ? left - o.grid[0] : left + o.grid[0])) : left;
1122 pageY - // The absolute mouse position
1123 this.offset.click.top - // Click offset (relative to the element)
1124 this.offset.relative.top - // Only for relative positioned nodes: Relative offset from element to offset parent
1125 this.offset.parent.top + // The offsetParent's offset without borders (offset + border)
1126 ( ( this.cssPosition === "fixed" ? -this.scrollParent.scrollTop() : ( scrollIsRootNode ? 0 : scroll.scrollTop() ) ))
1129 pageX - // The absolute mouse position
1130 this.offset.click.left - // Click offset (relative to the element)
1131 this.offset.relative.left - // Only for relative positioned nodes: Relative offset from element to offset parent
1132 this.offset.parent.left + // The offsetParent's offset without borders (offset + border)
1133 ( ( this.cssPosition === "fixed" ? -this.scrollParent.scrollLeft() : scrollIsRootNode ? 0 : scroll.scrollLeft() ))
1139 _rearrange: function(event, i, a, hardRefresh) {
1141 a ? a[0].appendChild(this.placeholder[0]) : i.item[0].parentNode.insertBefore(this.placeholder[0], (this.direction === "down" ? i.item[0] : i.item[0].nextSibling));
1143 //Various things done here to improve the performance:
1144 // 1. we create a setTimeout, that calls refreshPositions
1145 // 2. on the instance, we have a counter variable, that get's higher after every append
1146 // 3. on the local scope, we copy the counter variable, and check in the timeout, if it's still the same
1147 // 4. this lets only the last addition to the timeout stack through
1148 this.counter = this.counter ? ++this.counter : 1;
1149 var counter = this.counter;
1151 this._delay(function() {
1152 if(counter === this.counter) {
1153 this.refreshPositions(!hardRefresh); //Precompute after each DOM insertion, NOT on mousemove
1159 _clear: function(event, noPropagation) {
1161 this.reverting = false;
1162 // We delay all events that have to be triggered to after the point where the placeholder has been removed and
1163 // everything else normalized again
1165 delayedTriggers = [];
1167 // We first have to update the dom position of the actual currentItem
1168 // Note: don't do it if the current item is already removed (by a user), or it gets reappended (see #4088)
1169 if(!this._noFinalSort && this.currentItem.parent().length) {
1170 this.placeholder.before(this.currentItem);
1172 this._noFinalSort = null;
1174 if(this.helper[0] === this.currentItem[0]) {
1175 for(i in this._storedCSS) {
1176 if(this._storedCSS[i] === "auto" || this._storedCSS[i] === "static") {
1177 this._storedCSS[i] = "";
1180 this.currentItem.css(this._storedCSS).removeClass("ui-sortable-helper");
1182 this.currentItem.show();
1185 if(this.fromOutside && !noPropagation) {
1186 delayedTriggers.push(function(event) { this._trigger("receive", event, this._uiHash(this.fromOutside)); });
1188 if((this.fromOutside || this.domPosition.prev !== this.currentItem.prev().not(".ui-sortable-helper")[0] || this.domPosition.parent !== this.currentItem.parent()[0]) && !noPropagation) {
1189 delayedTriggers.push(function(event) { this._trigger("update", event, this._uiHash()); }); //Trigger update callback if the DOM position has changed
1192 // Check if the items Container has Changed and trigger appropriate
1194 if (this !== this.currentContainer) {
1195 if(!noPropagation) {
1196 delayedTriggers.push(function(event) { this._trigger("remove", event, this._uiHash()); });
1197 delayedTriggers.push((function(c) { return function(event) { c._trigger("receive", event, this._uiHash(this)); }; }).call(this, this.currentContainer));
1198 delayedTriggers.push((function(c) { return function(event) { c._trigger("update", event, this._uiHash(this)); }; }).call(this, this.currentContainer));
1203 //Post events to containers
1204 for (i = this.containers.length - 1; i >= 0; i--){
1205 if(!noPropagation) {
1206 delayedTriggers.push((function(c) { return function(event) { c._trigger("deactivate", event, this._uiHash(this)); }; }).call(this, this.containers[i]));
1208 if(this.containers[i].containerCache.over) {
1209 delayedTriggers.push((function(c) { return function(event) { c._trigger("out", event, this._uiHash(this)); }; }).call(this, this.containers[i]));
1210 this.containers[i].containerCache.over = 0;
1214 //Do what was originally in plugins
1215 if ( this.storedCursor ) {
1216 this.document.find( "body" ).css( "cursor", this.storedCursor );
1217 this.storedStylesheet.remove();
1219 if(this._storedOpacity) {
1220 this.helper.css("opacity", this._storedOpacity);
1222 if(this._storedZIndex) {
1223 this.helper.css("zIndex", this._storedZIndex === "auto" ? "" : this._storedZIndex);
1226 this.dragging = false;
1227 if(this.cancelHelperRemoval) {
1228 if(!noPropagation) {
1229 this._trigger("beforeStop", event, this._uiHash());
1230 for (i=0; i < delayedTriggers.length; i++) {
1231 delayedTriggers[i].call(this, event);
1232 } //Trigger all delayed events
1233 this._trigger("stop", event, this._uiHash());
1236 this.fromOutside = false;
1240 if(!noPropagation) {
1241 this._trigger("beforeStop", event, this._uiHash());
1244 //$(this.placeholder[0]).remove(); would have been the jQuery way - unfortunately, it unbinds ALL events from the original node!
1245 this.placeholder[0].parentNode.removeChild(this.placeholder[0]);
1247 if(this.helper[0] !== this.currentItem[0]) {
1248 this.helper.remove();
1252 if(!noPropagation) {
1253 for (i=0; i < delayedTriggers.length; i++) {
1254 delayedTriggers[i].call(this, event);
1255 } //Trigger all delayed events
1256 this._trigger("stop", event, this._uiHash());
1259 this.fromOutside = false;
1264 _trigger: function() {
1265 if ($.Widget.prototype._trigger.apply(this, arguments) === false) {
1270 _uiHash: function(_inst) {
1271 var inst = _inst || this;
1273 helper: inst.helper,
1274 placeholder: inst.placeholder || $([]),
1275 position: inst.position,
1276 originalPosition: inst.originalPosition,
1277 offset: inst.positionAbs,
1278 item: inst.currentItem,
1279 sender: _inst ? _inst.element : null