Sortable.js 13.8 KB
Newer Older
R
RubaXa 已提交
1 2 3 4 5 6 7 8 9 10 11
/**!
 * Sortable
 * @author	RubaXa   <trash@rubaxa.org>
 * @license MIT
 */


(function (factory){
	"use strict";

	if( typeof define === "function" && define.amd ){
R
RubaXa 已提交
12
		define(factory);
R
RubaXa 已提交
13
	}
S
Scott Nelson 已提交
14 15 16
	else if( typeof module != "undefined" && typeof module.exports != "undefined" ){
		module.exports = factory();
	}
R
RubaXa 已提交
17 18 19 20 21 22 23
	else {
		window["Sortable"] = factory();
	}
})(function (){
	"use strict";

	var
M
Marius Petcu 已提交
24
		  dragEl
R
RubaXa 已提交
25 26 27 28 29 30
		, ghostEl
		, rootEl
		, nextEl

		, lastEl
		, lastCSS
R
RubaXa 已提交
31
		, lastRect
R
RubaXa 已提交
32 33 34 35 36 37 38 39 40 41 42

		, activeGroup

		, tapEvt
		, touchEvt

		, expando = 'Sortable' + (new Date).getTime()

		, win = window
		, document = win.document
		, parseInt = win.parseInt
R
RubaXa 已提交
43 44
		, supportIEdnd = !!document.createElement('div').dragDrop

R
RubaXa 已提交
45
		, _silent = false
R
RubaXa 已提交
46

R
RubaXa 已提交
47 48 49 50 51 52
		, _createEvent = function (event/**String*/, item/**HTMLElement*/){
			var evt = document.createEvent('Event');
			evt.initEvent(event, true, true);
			evt.item = item;
			return evt;
		}
R
RubaXa 已提交
53 54 55 56 57 58 59 60

		, noop = function (){}
		, slice = [].slice

		, touchDragOverListeners = []
	;


61

R
RubaXa 已提交
62 63 64
	/**
	 * @class  Sortable
	 * @param  {HTMLElement}  el
65
	 * @param  {Object}       [options]
R
RubaXa 已提交
66 67 68 69 70 71 72 73
	 */
	function Sortable(el, options){
		this.el = el; // root element
		this.options = options = (options || {});


		// Defaults
		options.group = options.group || Math.random();
74
		options.store = options.store || null;
R
RubaXa 已提交
75
		options.handle = options.handle || null;
R
RubaXa 已提交
76
		options.draggable = options.draggable || el.children[0] && el.children[0].nodeName || (/[uo]l/i.test(el.nodeName) ? 'li' : '*');
R
RubaXa 已提交
77
		options.ghostClass = options.ghostClass || 'sortable-ghost';
Z
ziflex 已提交
78
		options.ignore = options.ignore || 'a, img';
R
RubaXa 已提交
79

80 81 82 83 84

		// Define events
		'onAdd onUpdate onRemove onStart onEnd'.split(' ').forEach(function (name) {
			options[name] = _bind(this, options[name] || noop);
		});
R
RubaXa 已提交
85 86


R
* JSDoc  
RubaXa 已提交
87
		// Export group name
R
RubaXa 已提交
88 89 90
		el[expando] = options.group;


R
* JSDoc  
RubaXa 已提交
91
		// Bind all private methods
R
RubaXa 已提交
92 93 94 95 96 97 98 99 100 101 102
		for( var fn in this ){
			if( fn.charAt(0) === '_' ){
				this[fn] = _bind(this, this[fn]);
			}
		}


		// Bind events
		_on(el, 'add', options.onAdd);
		_on(el, 'update', options.onUpdate);
		_on(el, 'remove', options.onRemove);
S
skaczorowski 已提交
103 104
		_on(el, 'start', options.onStart);
		_on(el, 'stop', options.onEnd);
R
RubaXa 已提交
105 106 107

		_on(el, 'mousedown', this._onTapStart);
		_on(el, 'touchstart', this._onTapStart);
R
RubaXa 已提交
108
		supportIEdnd && _on(el, 'selectstart', this._onTapStart);
R
RubaXa 已提交
109 110 111 112 113

		_on(el, 'dragover', this._onDragOver);
		_on(el, 'dragenter', this._onDragOver);

		touchDragOverListeners.push(this._onDragOver);
114 115 116

		// Restore sorting
		options.store && this.sort(options.store.get(this));
R
RubaXa 已提交
117 118 119
	}


120
	Sortable.prototype = /** @lends Sortable.prototype */ {
R
RubaXa 已提交
121 122 123 124 125 126 127 128
		constructor: Sortable,


		_applyEffects: function (){
			_toggleClass(dragEl, this.options.ghostClass, true);
		},


R
RubaXa 已提交
129
		_onTapStart: function (evt/**Event|TouchEvent*/){
R
RubaXa 已提交
130
			var
M
Marius Petcu 已提交
131
				  touch = evt.touches && evt.touches[0]
R
RubaXa 已提交
132 133
				, target = (touch || evt).target
				, options =  this.options
R
RubaXa 已提交
134
				, el = this.el
R
RubaXa 已提交
135 136 137
			;

			if( options.handle ){
R
RubaXa 已提交
138
				target = _closest(target, options.handle, el);
R
RubaXa 已提交
139 140
			}

R
RubaXa 已提交
141
			target = _closest(target, options.draggable, el);
R
RubaXa 已提交
142

R
RubaXa 已提交
143
			// IE 9 Support
144 145 146 147 148
			if( target && evt.type == 'selectstart' ){
				if( target.tagName != 'A' && target.tagName != 'IMG'){
					target.dragDrop();
				}
			}
N
Nicolas 已提交
149

R
RubaXa 已提交
150
			if( target && !dragEl && (target.parentNode === el) ){
R
RubaXa 已提交
151
				tapEvt = evt;
152 153 154 155 156 157 158

				rootEl = this.el;
				dragEl = target;
				nextEl = dragEl.nextSibling;
				activeGroup = this.options.group;

				dragEl.draggable = true;
R
RubaXa 已提交
159 160

				// Disable "draggable"
161
				options.ignore.split(',').forEach(function (criteria) {
Z
ziflex 已提交
162 163
					_find(target, criteria.trim(), _disableDraggable);
				});
R
RubaXa 已提交
164 165 166 167

				if( touch ){
					// Touch device support
					tapEvt = {
M
Marius Petcu 已提交
168
						  target:  target
R
RubaXa 已提交
169 170 171
						, clientX: touch.clientX
						, clientY: touch.clientY
					};
172

R
RubaXa 已提交
173 174 175
					this._onDragStart(tapEvt, true);
					evt.preventDefault();
				}
R
RubaXa 已提交
176

177 178 179
				_on(document, 'mouseup', this._onDrop);
				_on(document, 'touchend', this._onDrop);
				_on(document, 'touchcancel', this._onDrop);
R
RubaXa 已提交
180 181

				_on(this.el, 'dragstart', this._onDragStart);
R
RubaXa 已提交
182
				_on(this.el, 'dragend', this._onDrop);
R
RubaXa 已提交
183 184 185 186 187 188 189 190 191 192
				_on(document, 'dragover', _globalDragOver);


				try {
					if( document.selection ){
						document.selection.empty();
					} else {
						window.getSelection().removeAllRanges()
					}
				} catch (err){ }
193 194 195


				dragEl.dispatchEvent(_createEvent('start', dragEl));
R
RubaXa 已提交
196 197 198 199 200 201 202 203
			}
		},

		_emulateDragOver: function (){
			if( touchEvt ){
				_css(ghostEl, 'display', 'none');

				var
M
Marius Petcu 已提交
204
					  target = document.elementFromPoint(touchEvt.clientX, touchEvt.clientY)
R
RubaXa 已提交
205 206 207 208 209
					, parent = target
					, group = this.options.group
					, i = touchDragOverListeners.length
				;

L
Larry Davis 已提交
210 211 212 213 214 215 216 217 218 219 220 221
				if( parent ){
					do {
						if( parent[expando] === group ){
							while( i-- ){
								touchDragOverListeners[i]({
									clientX: touchEvt.clientX,
									clientY: touchEvt.clientY,
									target: target,
									rootEl: parent
								});
							}
							break;
R
RubaXa 已提交
222
						}
R
RubaXa 已提交
223

L
Larry Davis 已提交
224 225 226
						target = parent; // store last element
					}
					while( parent = parent.parentNode );
R
RubaXa 已提交
227 228 229 230 231 232 233
				}

				_css(ghostEl, 'display', '');
			}
		},


R
RubaXa 已提交
234
		_onTouchMove: function (evt/**TouchEvent*/){
R
RubaXa 已提交
235 236
			if( tapEvt ){
				var
M
Marius Petcu 已提交
237
					  touch = evt.touches[0]
R
RubaXa 已提交
238 239
					, dx = touch.clientX - tapEvt.clientX
					, dy = touch.clientY - tapEvt.clientY
R
RubaXa 已提交
240
					, translate3d = 'translate3d(' + dx + 'px,' + dy + 'px,0)'
R
RubaXa 已提交
241 242 243
				;

				touchEvt = touch;
R
RubaXa 已提交
244 245 246 247 248 249

				_css(ghostEl, 'webkitTransform', translate3d);
				_css(ghostEl, 'mozTransform', translate3d);
				_css(ghostEl, 'msTransform', translate3d);
				_css(ghostEl, 'transform', translate3d);

M
Marius Petcu 已提交
250
				evt.preventDefault();
R
RubaXa 已提交
251 252 253 254
			}
		},


R
* JSDoc  
RubaXa 已提交
255
		_onDragStart: function (evt/**Event*/, isTouch/**Boolean*/){
256
			var dataTransfer = evt.dataTransfer;
R
RubaXa 已提交
257

258
			this._offUpEvents();
R
RubaXa 已提交
259 260

			if( isTouch ){
R
RubaXa 已提交
261
				var
262 263
					  rect = dragEl.getBoundingClientRect()
					, css = _css(dragEl)
R
RubaXa 已提交
264 265
					, ghostRect
				;
R
RubaXa 已提交
266

267
				ghostEl = dragEl.cloneNode(true);
R
RubaXa 已提交
268 269 270

				_css(ghostEl, 'top', rect.top - parseInt(css.marginTop, 10));
				_css(ghostEl, 'left', rect.left - parseInt(css.marginLeft, 10));
R
RubaXa 已提交
271 272
				_css(ghostEl, 'width', rect.width);
				_css(ghostEl, 'height', rect.height);
R
RubaXa 已提交
273 274 275 276
				_css(ghostEl, 'opacity', '0.8');
				_css(ghostEl, 'position', 'fixed');
				_css(ghostEl, 'zIndex', '100000');

R
RubaXa 已提交
277 278 279 280 281 282
				rootEl.appendChild(ghostEl);

				// Fixing dimensions.
				ghostRect = ghostEl.getBoundingClientRect();
				_css(ghostEl, 'width', rect.width*2 - ghostRect.width);
				_css(ghostEl, 'height', rect.height*2 - ghostRect.height);
R
RubaXa 已提交
283 284 285 286

				// Bind touch events
				_on(document, 'touchmove', this._onTouchMove);
				_on(document, 'touchend', this._onDrop);
M
Marius Petcu 已提交
287
				_on(document, 'touchcancel', this._onDrop);
R
RubaXa 已提交
288

R
RubaXa 已提交
289
				this._loopId = setInterval(this._emulateDragOver, 150);
R
RubaXa 已提交
290 291 292
			}
			else {
				dataTransfer.effectAllowed = 'move';
293
				dataTransfer.setData('Text', dragEl.textContent);
R
RubaXa 已提交
294 295 296 297 298 299 300 301

				_on(document, 'drop', this._onDrop);
			}

			setTimeout(this._applyEffects);
		},


R
* JSDoc  
RubaXa 已提交
302
		_onDragOver: function (evt/**Event*/){
R
RubaXa 已提交
303
			if( !_silent && (activeGroup === this.options.group) && (evt.rootEl === void 0 || evt.rootEl === this.el) ){
R
RubaXa 已提交
304
				var
M
Marius Petcu 已提交
305
					  el = this.el
R
RubaXa 已提交
306 307 308
					, target = _closest(evt.target, this.options.draggable, el)
				;

R
RubaXa 已提交
309
				if( el.children.length === 0 || el.children[0] === ghostEl || (el === evt.target) && _ghostInBottom(el, evt) ){
R
RubaXa 已提交
310 311 312 313 314
					el.appendChild(dragEl);
				}
				else if( target && target !== dragEl && (target.parentNode[expando] !== void 0) ){
					if( lastEl !== target ){
						lastEl = target;
R
RubaXa 已提交
315 316
						lastCSS = _css(target);
						lastRect = target.getBoundingClientRect();
R
RubaXa 已提交
317 318 319
					}


R
RubaXa 已提交
320
					var
M
Marius Petcu 已提交
321
						  rect = lastRect
R
RubaXa 已提交
322 323 324 325 326
						, width = rect.right - rect.left
						, height = rect.bottom - rect.top
						, floating = /left|right|inline/.test(lastCSS.cssFloat + lastCSS.display)
						, isWide = (target.offsetWidth > dragEl.offsetWidth)
						, isLong = (target.offsetHeight > dragEl.offsetHeight)
R
RubaXa 已提交
327
						, halfway = (floating ? (evt.clientX - rect.left)/width : (evt.clientY - rect.top)/height) > .5
D
Dmitry Minkovsky 已提交
328
						, nextSibling = target.nextElementSibling
R
RubaXa 已提交
329 330
						, after
					;
R
RubaXa 已提交
331

R
RubaXa 已提交
332 333 334 335
					_silent = true;
					setTimeout(_unsilent, 30);

					if( floating ){
R
RubaXa 已提交
336
						after = (target.previousElementSibling === dragEl) && !isWide || halfway && isWide
R
RubaXa 已提交
337
					} else {
R
RubaXa 已提交
338
						after = (nextSibling !== dragEl) && !isLong || halfway && isLong;
R
RubaXa 已提交
339 340 341 342 343 344
					}

					if( after && !nextSibling ){
						el.appendChild(dragEl);
					} else {
						target.parentNode.insertBefore(dragEl, after ? nextSibling : target);
R
RubaXa 已提交
345 346 347 348 349
					}
				}
			}
		},

350 351 352 353 354 355
		_offUpEvents: function () {
			_off(document, 'mouseup', this._onDrop);
			_off(document, 'touchmove', this._onTouchMove);
			_off(document, 'touchend', this._onDrop);
			_off(document, 'touchcancel', this._onDrop);
		},
R
RubaXa 已提交
356 357 358 359 360 361 362 363

		_onDrop: function (evt/**Event*/){
			clearInterval(this._loopId);

			// Unbind events
			_off(document, 'drop', this._onDrop);
			_off(document, 'dragover', _globalDragOver);

R
RubaXa 已提交
364
			_off(this.el, 'dragend', this._onDrop);
R
RubaXa 已提交
365
			_off(this.el, 'dragstart', this._onDragStart);
N
Nicolas 已提交
366
			_off(this.el, 'selectstart', this._onTapStart);
R
RubaXa 已提交
367

368
			this._offUpEvents();
R
RubaXa 已提交
369 370 371

			if( evt ){
				evt.preventDefault();
R
RubaXa 已提交
372
				evt.stopPropagation();
R
RubaXa 已提交
373

R
RubaXa 已提交
374 375 376 377
				if( ghostEl ){
					ghostEl.parentNode.removeChild(ghostEl);
				}

R
RubaXa 已提交
378
				if( dragEl ){
379
					_disableDraggable(dragEl);
R
RubaXa 已提交
380 381 382 383
					_toggleClass(dragEl, this.options.ghostClass, false);

					if( !rootEl.contains(dragEl) ){
						// Remove event
R
RubaXa 已提交
384
						rootEl.dispatchEvent(_createEvent('remove', dragEl));
R
RubaXa 已提交
385 386

						// Add event
R
RubaXa 已提交
387
						dragEl.dispatchEvent(_createEvent('add', dragEl));
R
RubaXa 已提交
388 389 390
					}
					else if( dragEl.nextSibling !== nextEl ){
						// Update event
R
RubaXa 已提交
391
						dragEl.dispatchEvent(_createEvent('update', dragEl));
R
RubaXa 已提交
392
					}
393

S
skaczorowski 已提交
394
					dragEl.dispatchEvent(_createEvent('stop', dragEl));
R
RubaXa 已提交
395 396 397 398 399 400 401 402 403 404 405 406 407 408 409
				}

				// Set NULL
				rootEl =
				dragEl =
				ghostEl =
				nextEl =

				tapEvt =
				touchEvt =

				lastEl =
				lastCSS =

				activeGroup = null;
410 411 412

				// Save sorting
				this.options.store && this.options.store.set(this);
R
RubaXa 已提交
413 414 415 416
			}
		},


417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461
		/**
		 * Serializes the item into an array of string.
		 * @returns {String[]}
		 */
		toArray: function () {
			var order = [],
				el,
				children = this.el.children,
				i = 0,
				n = children.length
			;

			for (; i < n; i++) {
				el = children[i];
				order.push(el.getAttribute('data-id') || _generateId(el));
			}

			return order;
		},


		/**
		 * Sorts the elements according to the array.
		 * @param  {String[]}  order  order of the items
		 */
		sort: function (order) {
			var items = {}, el = this.el;

			this.toArray().forEach(function (id, i) {
				items[id] = el.children[i];
			});

			order.forEach(function (id) {
				if (items[id]) {
					el.removeChild(items[id]);
					el.appendChild(items[id]);
				}
			});
		},


		/**
		 * Destroy
		 */
		destroy: function () {
R
RubaXa 已提交
462 463 464 465 466
			var el = this.el, options = this.options;

			_off(el, 'add', options.onAdd);
			_off(el, 'update', options.onUpdate);
			_off(el, 'remove', options.onRemove);
S
skaczorowski 已提交
467 468
			_off(el, 'start', options.onStart);
			_off(el, 'stop', options.onEnd);
R
RubaXa 已提交
469 470
			_off(el, 'mousedown', this._onTapStart);
			_off(el, 'touchstart', this._onTapStart);
N
Nicolas 已提交
471
			_off(el, 'selectstart', this._onTapStart);
R
RubaXa 已提交
472 473 474 475

			_off(el, 'dragover', this._onDragOver);
			_off(el, 'dragenter', this._onDragOver);

476 477 478 479 480
			//remove draggable attributes
			Array.prototype.forEach.call(el.querySelectorAll('[draggable]'), function(el) {
				el.removeAttribute('draggable');
			});

R
RubaXa 已提交
481 482 483 484 485 486 487 488
			touchDragOverListeners.splice(touchDragOverListeners.indexOf(this._onDragOver), 1);

			this._onDrop();

			this.el = null;
		}
	};

489

R
RubaXa 已提交
490 491 492 493 494 495 496 497 498
	function _bind(ctx, fn){
		var args = slice.call(arguments, 2);
		return	fn.bind ? fn.bind.apply(fn, [ctx].concat(args)) : function (){
			return fn.apply(ctx, args.concat(slice.call(arguments)));
		};
	}


	function _closest(el, selector, ctx){
R
RubaXa 已提交
499 500 501 502
		if( selector === '*' ){
			return el;
		}
		else if( el ){
R
RubaXa 已提交
503 504 505 506
			ctx = ctx || document;
			selector = selector.split('.');

			var
M
Marius Petcu 已提交
507
				  tag = selector.shift().toUpperCase()
R
RubaXa 已提交
508
				, re = new RegExp('\\s('+selector.join('|')+')\\s', 'g')
R
RubaXa 已提交
509 510 511 512
			;

			do {
				if(
M
Marius Petcu 已提交
513
					   (tag === '' || el.nodeName == tag)
R
RubaXa 已提交
514
					&& (!selector.length || ((' '+el.className+' ').match(re) || []).length == selector.length)
R
RubaXa 已提交
515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547
				){
					return	el;
				}
			}
			while( el !== ctx && (el = el.parentNode) );
		}

		return	null;
	}


	function _globalDragOver(evt){
		evt.dataTransfer.dropEffect = 'move';
		evt.preventDefault();
	}


	function _on(el, event, fn){
		el.addEventListener(event, fn, false);
	}


	function _off(el, event, fn){
		el.removeEventListener(event, fn, false);
	}


	function _toggleClass(el, name, state){
		if( el ){
			if( el.classList ){
				el.classList[state ? 'add' : 'remove'](name);
			}
			else {
R
RubaXa 已提交
548
				var className = (' '+el.className+' ').replace(/\s+/g, ' ').replace(' '+name+' ', '');
R
RubaXa 已提交
549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590
				el.className = className + (state ? ' '+name : '')
			}
		}
	}


	function _css(el, prop, val){
		if( el && el.style ){
			if( val === void 0 ){
				if( document.defaultView && document.defaultView.getComputedStyle ){
					val = document.defaultView.getComputedStyle(el, '');
				}
				else if( el.currentStyle ){
					val	= el.currentStyle;
				}
				return	prop === void 0 ? val : val[prop];
			} else {
				el.style[prop] = val + (typeof val === 'string' ? '' : 'px');
			}
		}
	}


	function _find(ctx, tagName, iterator){
		if( ctx ){
			var list = ctx.getElementsByTagName(tagName), i = 0, n = list.length;
			if( iterator ){
				for( ; i < n; i++ ){
					iterator(list[i], i);
				}
			}
			return	list;
		}
		return	[];
	}


	function _disableDraggable(el){
		return el.draggable = false;
	}


R
RubaXa 已提交
591 592 593 594 595
	function _unsilent(){
		_silent = false;
	}


R
RubaXa 已提交
596 597 598 599 600 601
	function _ghostInBottom(el, evt){
		var last = el.lastElementChild.getBoundingClientRect();
		return evt.clientY - (last.top + last.height) > 5; // min delta
	}


602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618
	/**
	 * Generate id
	 * @param   {HTMLElement} el
	 * @returns {String}
	 * @private
	 */
	function _generateId(el) {
		var str = el.innerHTML + el.className + el.src,
			i = str.length,
			sum = 0
		;
		while (i--) {
			sum += str.charCodeAt(i);
		}
		return sum.toString(36);
	}

R
RubaXa 已提交
619 620 621 622 623 624 625 626 627 628 629 630 631

	// Export utils
	Sortable.utils = {
		on: _on,
		off: _off,
		css: _css,
		find: _find,
		bind: _bind,
		closest: _closest,
		toggleClass: _toggleClass
	};


R
RubaXa 已提交
632
	Sortable.version = '0.4.1';
633

R
RubaXa 已提交
634 635 636 637

	// Export
	return	Sortable;
});