1 // Copyright (c) 2005-2008 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
2 // (c) 2005-2008 Sammi Williams (http://www.oriontransfer.co.nz, sammi@oriontransfer.co.nz)
4 // script.aculo.us is freely distributable under the terms of an MIT-style license.
5 // For details, see the script.aculo.us web site: http://script.aculo.us/
7 if(Object.isUndefined(Effect))
8 throw("dragdrop.js requires including script.aculo.us' effects.js library");
13 remove: function(element) {
14 this.drops = this.drops.reject(function(d) { return d.element==$(element) });
17 add: function(element) {
19 var options = Object.extend({
23 }, arguments[1] || { });
26 if(options.containment) {
27 options._containers = [];
28 var containment = options.containment;
29 if(Object.isArray(containment)) {
30 containment.each( function(c) { options._containers.push($(c)) });
32 options._containers.push($(containment));
36 if(options.accept) options.accept = [options.accept].flatten();
38 Element.makePositioned(element); // fix IE
39 options.element = element;
41 this.drops.push(options);
44 findDeepestChild: function(drops) {
47 for (i = 1; i < drops.length; ++i)
48 if (Element.isParent(drops[i].element, deepest.element))
54 isContained: function(element, drop) {
57 containmentNode = element.treeNode;
59 containmentNode = element.parentNode;
61 return drop._containers.detect(function(c) { return containmentNode == c });
64 isAffected: function(point, element, drop) {
66 (drop.element!=element) &&
67 ((!drop._containers) ||
68 this.isContained(element, drop)) &&
70 (Element.classNames(element).detect(
71 function(v) { return drop.accept.include(v) } ) )) &&
72 Position.within(drop.element, point[0], point[1]) );
75 deactivate: function(drop) {
77 Element.removeClassName(drop.element, drop.hoverclass);
78 this.last_active = null;
81 activate: function(drop) {
83 Element.addClassName(drop.element, drop.hoverclass);
84 this.last_active = drop;
87 show: function(point, element) {
88 if(!this.drops.length) return;
89 var drop, affected = [];
91 this.drops.each( function(drop) {
92 if(Droppables.isAffected(point, element, drop))
97 drop = Droppables.findDeepestChild(affected);
99 if(this.last_active && this.last_active != drop) this.deactivate(this.last_active);
101 Position.within(drop.element, point[0], point[1]);
103 drop.onHover(element, drop.element, Position.overlap(drop.overlap, drop.element));
105 if (drop != this.last_active) Droppables.activate(drop);
109 fire: function(event, element) {
110 if(!this.last_active) return;
113 if (this.isAffected([Event.pointerX(event), Event.pointerY(event)], element, this.last_active))
114 if (this.last_active.onDrop) {
115 this.last_active.onDrop(element, this.last_active.element, event);
122 this.deactivate(this.last_active);
130 register: function(draggable) {
131 if(this.drags.length == 0) {
132 this.eventMouseUp = this.endDrag.bindAsEventListener(this);
133 this.eventMouseMove = this.updateDrag.bindAsEventListener(this);
134 this.eventKeypress = this.keyPress.bindAsEventListener(this);
136 Event.observe(document, "mouseup", this.eventMouseUp);
137 Event.observe(document, "mousemove", this.eventMouseMove);
138 Event.observe(document, "keypress", this.eventKeypress);
140 this.drags.push(draggable);
143 unregister: function(draggable) {
144 this.drags = this.drags.reject(function(d) { return d==draggable });
145 if(this.drags.length == 0) {
146 Event.stopObserving(document, "mouseup", this.eventMouseUp);
147 Event.stopObserving(document, "mousemove", this.eventMouseMove);
148 Event.stopObserving(document, "keypress", this.eventKeypress);
152 activate: function(draggable) {
153 if(draggable.options.delay) {
154 this._timeout = setTimeout(function() {
155 Draggables._timeout = null;
157 Draggables.activeDraggable = draggable;
158 }.bind(this), draggable.options.delay);
160 window.focus(); // allows keypress events if window isn't currently focused, fails for Safari
161 this.activeDraggable = draggable;
165 deactivate: function() {
166 this.activeDraggable = null;
169 updateDrag: function(event) {
170 if(!this.activeDraggable) return;
171 var pointer = [Event.pointerX(event), Event.pointerY(event)];
172 // Mozilla-based browsers fire successive mousemove events with
173 // the same coordinates, prevent needless redrawing (moz bug?)
174 if(this._lastPointer && (this._lastPointer.inspect() == pointer.inspect())) return;
175 this._lastPointer = pointer;
177 this.activeDraggable.updateDrag(event, pointer);
180 endDrag: function(event) {
182 clearTimeout(this._timeout);
183 this._timeout = null;
185 if(!this.activeDraggable) return;
186 this._lastPointer = null;
187 this.activeDraggable.endDrag(event);
188 this.activeDraggable = null;
191 keyPress: function(event) {
192 if(this.activeDraggable)
193 this.activeDraggable.keyPress(event);
196 addObserver: function(observer) {
197 this.observers.push(observer);
198 this._cacheObserverCallbacks();
201 removeObserver: function(element) { // element instead of observer fixes mem leaks
202 this.observers = this.observers.reject( function(o) { return o.element==element });
203 this._cacheObserverCallbacks();
206 notify: function(eventName, draggable, event) { // 'onStart', 'onEnd', 'onDrag'
207 if(this[eventName+'Count'] > 0)
208 this.observers.each( function(o) {
209 if(o[eventName]) o[eventName](eventName, draggable, event);
211 if(draggable.options[eventName]) draggable.options[eventName](draggable, event);
214 _cacheObserverCallbacks: function() {
215 ['onStart','onEnd','onDrag'].each( function(eventName) {
216 Draggables[eventName+'Count'] = Draggables.observers.select(
217 function(o) { return o[eventName]; }
223 /*--------------------------------------------------------------------------*/
225 var Draggable = Class.create({
226 initialize: function(element) {
229 reverteffect: function(element, top_offset, left_offset) {
230 var dur = Math.sqrt(Math.abs(top_offset^2)+Math.abs(left_offset^2))*0.02;
231 new Effect.Move(element, { x: -left_offset, y: -top_offset, duration: dur,
232 queue: {scope:'_draggable', position:'end'}
235 endeffect: function(element) {
236 var toOpacity = Object.isNumber(element._opacity) ? element._opacity : 1.0;
237 new Effect.Opacity(element, {duration:0.2, from:0.7, to:toOpacity,
238 queue: {scope:'_draggable', position:'end'},
239 afterFinish: function(){
240 Draggable._dragging[element] = false
248 scrollSensitivity: 20,
250 snap: false, // false, or xy or [x,y] or function(x,y){ return [x,y] }
254 if(!arguments[1] || Object.isUndefined(arguments[1].endeffect))
255 Object.extend(defaults, {
256 starteffect: function(element) {
257 element._opacity = Element.getOpacity(element);
258 Draggable._dragging[element] = true;
259 new Effect.Opacity(element, {duration:0.2, from:element._opacity, to:0.7});
263 var options = Object.extend(defaults, arguments[1] || { });
265 this.element = $(element);
267 if(options.handle && Object.isString(options.handle))
268 this.handle = this.element.down('.'+options.handle, 0);
270 if(!this.handle) this.handle = $(options.handle);
271 if(!this.handle) this.handle = this.element;
273 if(options.scroll && !options.scroll.scrollTo && !options.scroll.outerHTML) {
274 options.scroll = $(options.scroll);
275 this._isScrollChild = Element.childOf(this.element, options.scroll);
278 Element.makePositioned(this.element); // fix IE
280 this.options = options;
281 this.dragging = false;
283 this.eventMouseDown = this.initDrag.bindAsEventListener(this);
284 Event.observe(this.handle, "mousedown", this.eventMouseDown);
286 Draggables.register(this);
289 destroy: function() {
290 Event.stopObserving(this.handle, "mousedown", this.eventMouseDown);
291 Draggables.unregister(this);
294 currentDelta: function() {
296 parseInt(Element.getStyle(this.element,'left') || '0'),
297 parseInt(Element.getStyle(this.element,'top') || '0')]);
300 initDrag: function(event) {
301 if(!Object.isUndefined(Draggable._dragging[this.element]) &&
302 Draggable._dragging[this.element]) return;
303 if(Event.isLeftClick(event)) {
304 // abort on form elements, fixes a Firefox issue
305 var src = Event.element(event);
306 if((tag_name = src.tagName.toUpperCase()) && (
308 tag_name=='SELECT' ||
309 tag_name=='OPTION' ||
310 tag_name=='BUTTON' ||
311 tag_name=='TEXTAREA')) return;
313 var pointer = [Event.pointerX(event), Event.pointerY(event)];
314 var pos = Position.cumulativeOffset(this.element);
315 this.offset = [0,1].map( function(i) { return (pointer[i] - pos[i]) });
317 Draggables.activate(this);
322 startDrag: function(event) {
323 this.dragging = true;
325 this.delta = this.currentDelta();
327 if(this.options.zindex) {
328 this.originalZ = parseInt(Element.getStyle(this.element,'z-index') || 0);
329 this.element.style.zIndex = this.options.zindex;
332 if(this.options.ghosting) {
333 this._clone = this.element.cloneNode(true);
334 this._originallyAbsolute = (this.element.getStyle('position') == 'absolute');
335 if (!this._originallyAbsolute)
336 Position.absolutize(this.element);
337 this.element.parentNode.insertBefore(this._clone, this.element);
340 if(this.options.scroll) {
341 if (this.options.scroll == window) {
342 var where = this._getWindowScroll(this.options.scroll);
343 this.originalScrollLeft = where.left;
344 this.originalScrollTop = where.top;
346 this.originalScrollLeft = this.options.scroll.scrollLeft;
347 this.originalScrollTop = this.options.scroll.scrollTop;
351 Draggables.notify('onStart', this, event);
353 if(this.options.starteffect) this.options.starteffect(this.element);
356 updateDrag: function(event, pointer) {
357 if(!this.dragging) this.startDrag(event);
359 if(!this.options.quiet){
361 Droppables.show(pointer, this.element);
364 Draggables.notify('onDrag', this, event);
367 if(this.options.change) this.options.change(this);
369 if(this.options.scroll) {
370 this.stopScrolling();
373 if (this.options.scroll == window) {
374 with(this._getWindowScroll(this.options.scroll)) { p = [ left, top, left+width, top+height ]; }
376 p = Position.page(this.options.scroll);
377 p[0] += this.options.scroll.scrollLeft + Position.deltaX;
378 p[1] += this.options.scroll.scrollTop + Position.deltaY;
379 p.push(p[0]+this.options.scroll.offsetWidth);
380 p.push(p[1]+this.options.scroll.offsetHeight);
383 if(pointer[0] < (p[0]+this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[0]+this.options.scrollSensitivity);
384 if(pointer[1] < (p[1]+this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[1]+this.options.scrollSensitivity);
385 if(pointer[0] > (p[2]-this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[2]-this.options.scrollSensitivity);
386 if(pointer[1] > (p[3]-this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[3]-this.options.scrollSensitivity);
387 this.startScrolling(speed);
390 // fix AppleWebKit rendering
391 if(Prototype.Browser.WebKit) window.scrollBy(0,0);
396 finishDrag: function(event, success) {
397 this.dragging = false;
399 if(this.options.quiet){
401 var pointer = [Event.pointerX(event), Event.pointerY(event)];
402 Droppables.show(pointer, this.element);
405 if(this.options.ghosting) {
406 if (!this._originallyAbsolute)
407 Position.relativize(this.element);
408 delete this._originallyAbsolute;
409 Element.remove(this._clone);
415 dropped = Droppables.fire(event, this.element);
416 if (!dropped) dropped = false;
418 if(dropped && this.options.onDropped) this.options.onDropped(this.element);
419 Draggables.notify('onEnd', this, event);
421 var revert = this.options.revert;
422 if(revert && Object.isFunction(revert)) revert = revert(this.element);
424 var d = this.currentDelta();
425 if(revert && this.options.reverteffect) {
426 if (dropped == 0 || revert != 'failure')
427 this.options.reverteffect(this.element,
428 d[1]-this.delta[1], d[0]-this.delta[0]);
433 if(this.options.zindex)
434 this.element.style.zIndex = this.originalZ;
436 if(this.options.endeffect)
437 this.options.endeffect(this.element);
439 Draggables.deactivate(this);
443 keyPress: function(event) {
444 if(event.keyCode!=Event.KEY_ESC) return;
445 this.finishDrag(event, false);
449 endDrag: function(event) {
450 if(!this.dragging) return;
451 this.stopScrolling();
452 this.finishDrag(event, true);
456 draw: function(point) {
457 var pos = Position.cumulativeOffset(this.element);
458 if(this.options.ghosting) {
459 var r = Position.realOffset(this.element);
460 pos[0] += r[0] - Position.deltaX; pos[1] += r[1] - Position.deltaY;
463 var d = this.currentDelta();
464 pos[0] -= d[0]; pos[1] -= d[1];
466 if(this.options.scroll && (this.options.scroll != window && this._isScrollChild)) {
467 pos[0] -= this.options.scroll.scrollLeft-this.originalScrollLeft;
468 pos[1] -= this.options.scroll.scrollTop-this.originalScrollTop;
471 var p = [0,1].map(function(i){
472 return (point[i]-pos[i]-this.offset[i])
475 if(this.options.snap) {
476 if(Object.isFunction(this.options.snap)) {
477 p = this.options.snap(p[0],p[1],this);
479 if(Object.isArray(this.options.snap)) {
480 p = p.map( function(v, i) {
481 return (v/this.options.snap[i]).round()*this.options.snap[i] }.bind(this));
483 p = p.map( function(v) {
484 return (v/this.options.snap).round()*this.options.snap }.bind(this));
488 var style = this.element.style;
489 if((!this.options.constraint) || (this.options.constraint=='horizontal'))
490 style.left = p[0] + "px";
491 if((!this.options.constraint) || (this.options.constraint=='vertical'))
492 style.top = p[1] + "px";
494 if(style.visibility=="hidden") style.visibility = ""; // fix gecko rendering
497 stopScrolling: function() {
498 if(this.scrollInterval) {
499 clearInterval(this.scrollInterval);
500 this.scrollInterval = null;
501 Draggables._lastScrollPointer = null;
505 startScrolling: function(speed) {
506 if(!(speed[0] || speed[1])) return;
507 this.scrollSpeed = [speed[0]*this.options.scrollSpeed,speed[1]*this.options.scrollSpeed];
508 this.lastScrolled = new Date();
509 this.scrollInterval = setInterval(this.scroll.bind(this), 10);
513 var current = new Date();
514 var delta = current - this.lastScrolled;
515 this.lastScrolled = current;
516 if(this.options.scroll == window) {
517 with (this._getWindowScroll(this.options.scroll)) {
518 if (this.scrollSpeed[0] || this.scrollSpeed[1]) {
519 var d = delta / 1000;
520 this.options.scroll.scrollTo( left + d*this.scrollSpeed[0], top + d*this.scrollSpeed[1] );
524 this.options.scroll.scrollLeft += this.scrollSpeed[0] * delta / 1000;
525 this.options.scroll.scrollTop += this.scrollSpeed[1] * delta / 1000;
529 Droppables.show(Draggables._lastPointer, this.element);
530 Draggables.notify('onDrag', this);
531 if (this._isScrollChild) {
532 Draggables._lastScrollPointer = Draggables._lastScrollPointer || $A(Draggables._lastPointer);
533 Draggables._lastScrollPointer[0] += this.scrollSpeed[0] * delta / 1000;
534 Draggables._lastScrollPointer[1] += this.scrollSpeed[1] * delta / 1000;
535 if (Draggables._lastScrollPointer[0] < 0)
536 Draggables._lastScrollPointer[0] = 0;
537 if (Draggables._lastScrollPointer[1] < 0)
538 Draggables._lastScrollPointer[1] = 0;
539 this.draw(Draggables._lastScrollPointer);
542 if(this.options.change) this.options.change(this);
545 _getWindowScroll: function(w) {
548 if (w.document.documentElement && documentElement.scrollTop) {
549 T = documentElement.scrollTop;
550 L = documentElement.scrollLeft;
551 } else if (w.document.body) {
558 } else if (w.document.documentElement && documentElement.clientWidth) {
559 W = documentElement.clientWidth;
560 H = documentElement.clientHeight;
562 W = body.offsetWidth;
563 H = body.offsetHeight;
566 return { top: T, left: L, width: W, height: H };
570 Draggable._dragging = { };
572 /*--------------------------------------------------------------------------*/
574 var SortableObserver = Class.create({
575 initialize: function(element, observer) {
576 this.element = $(element);
577 this.observer = observer;
578 this.lastValue = Sortable.serialize(this.element);
581 onStart: function() {
582 this.lastValue = Sortable.serialize(this.element);
587 if(this.lastValue != Sortable.serialize(this.element))
588 this.observer(this.element)
593 SERIALIZE_RULE: /^[^_\-](?:[A-Za-z0-9\-\_]*)[_](.*)$/,
597 _findRootElement: function(element) {
598 while (element.tagName.toUpperCase() != "BODY") {
599 if(element.id && Sortable.sortables[element.id]) return element;
600 element = element.parentNode;
604 options: function(element) {
605 element = Sortable._findRootElement($(element));
607 return Sortable.sortables[element.id];
610 destroy: function(element){
611 element = $(element);
612 var s = Sortable.sortables[element.id];
615 Draggables.removeObserver(s.element);
616 s.droppables.each(function(d){ Droppables.remove(d) });
617 s.draggables.invoke('destroy');
619 delete Sortable.sortables[s.element.id];
623 create: function(element) {
624 element = $(element);
625 var options = Object.extend({
627 tag: 'li', // assumes li children, override with tag: 'tagname'
631 overlap: 'vertical', // one of 'vertical', 'horizontal'
632 constraint: 'vertical', // one of 'vertical', 'horizontal', false
633 containment: element, // also takes array of elements (or id's); or false
634 handle: false, // or a CSS class
641 scrollSensitivity: 20,
643 format: this.SERIALIZE_RULE,
645 // these take arrays of elements or ids and can be
646 // used for better initialization performance
650 onChange: Prototype.emptyFunction,
651 onUpdate: Prototype.emptyFunction
652 }, arguments[1] || { });
654 // clear any old sortable with same element
655 this.destroy(element);
657 // build options for the draggables
658 var options_for_draggable = {
660 quiet: options.quiet,
661 scroll: options.scroll,
662 scrollSpeed: options.scrollSpeed,
663 scrollSensitivity: options.scrollSensitivity,
664 delay: options.delay,
665 ghosting: options.ghosting,
666 constraint: options.constraint,
667 handle: options.handle };
669 if(options.starteffect)
670 options_for_draggable.starteffect = options.starteffect;
672 if(options.reverteffect)
673 options_for_draggable.reverteffect = options.reverteffect;
675 if(options.ghosting) options_for_draggable.reverteffect = function(element) {
676 element.style.top = 0;
677 element.style.left = 0;
680 if(options.endeffect)
681 options_for_draggable.endeffect = options.endeffect;
684 options_for_draggable.zindex = options.zindex;
686 // build options for the droppables
687 var options_for_droppable = {
688 overlap: options.overlap,
689 containment: options.containment,
691 hoverclass: options.hoverclass,
692 onHover: Sortable.onHover
695 var options_for_tree = {
696 onHover: Sortable.onEmptyHover,
697 overlap: options.overlap,
698 containment: options.containment,
699 hoverclass: options.hoverclass
702 // fix for gecko engine
703 Element.cleanWhitespace(element);
705 options.draggables = [];
706 options.droppables = [];
708 // drop on empty handling
709 if(options.dropOnEmpty || options.tree) {
710 Droppables.add(element, options_for_tree);
711 options.droppables.push(element);
714 (options.elements || this.findElements(element, options) || []).each( function(e,i) {
715 var handle = options.handles ? $(options.handles[i]) :
716 (options.handle ? $(e).select('.' + options.handle)[0] : e);
717 options.draggables.push(
718 new Draggable(e, Object.extend(options_for_draggable, { handle: handle })));
719 Droppables.add(e, options_for_droppable);
720 if(options.tree) e.treeNode = element;
721 options.droppables.push(e);
725 (Sortable.findTreeElements(element, options) || []).each( function(e) {
726 Droppables.add(e, options_for_tree);
727 e.treeNode = element;
728 options.droppables.push(e);
733 this.sortables[element.id] = options;
736 Draggables.addObserver(new SortableObserver(element, options.onUpdate));
740 // return all suitable-for-sortable elements in a guaranteed order
741 findElements: function(element, options) {
742 return Element.findChildren(
743 element, options.only, options.tree ? true : false, options.tag);
746 findTreeElements: function(element, options) {
747 return Element.findChildren(
748 element, options.only, options.tree ? true : false, options.treeTag);
751 onHover: function(element, dropon, overlap) {
752 if(Element.isParent(dropon, element)) return;
754 if(overlap > .33 && overlap < .66 && Sortable.options(dropon).tree) {
756 } else if(overlap>0.5) {
757 Sortable.mark(dropon, 'before');
758 if(dropon.previousSibling != element) {
759 var oldParentNode = element.parentNode;
760 element.style.visibility = "hidden"; // fix gecko rendering
761 dropon.parentNode.insertBefore(element, dropon);
762 if(dropon.parentNode!=oldParentNode)
763 Sortable.options(oldParentNode).onChange(element);
764 Sortable.options(dropon.parentNode).onChange(element);
767 Sortable.mark(dropon, 'after');
768 var nextElement = dropon.nextSibling || null;
769 if(nextElement != element) {
770 var oldParentNode = element.parentNode;
771 element.style.visibility = "hidden"; // fix gecko rendering
772 dropon.parentNode.insertBefore(element, nextElement);
773 if(dropon.parentNode!=oldParentNode)
774 Sortable.options(oldParentNode).onChange(element);
775 Sortable.options(dropon.parentNode).onChange(element);
780 onEmptyHover: function(element, dropon, overlap) {
781 var oldParentNode = element.parentNode;
782 var droponOptions = Sortable.options(dropon);
784 if(!Element.isParent(dropon, element)) {
787 var children = Sortable.findElements(dropon, {tag: droponOptions.tag, only: droponOptions.only});
791 var offset = Element.offsetSize(dropon, droponOptions.overlap) * (1.0 - overlap);
793 for (index = 0; index < children.length; index += 1) {
794 if (offset - Element.offsetSize (children[index], droponOptions.overlap) >= 0) {
795 offset -= Element.offsetSize (children[index], droponOptions.overlap);
796 } else if (offset - (Element.offsetSize (children[index], droponOptions.overlap) / 2) >= 0) {
797 child = index + 1 < children.length ? children[index + 1] : null;
800 child = children[index];
806 dropon.insertBefore(element, child);
808 Sortable.options(oldParentNode).onChange(element);
809 droponOptions.onChange(element);
814 if(Sortable._marker) Sortable._marker.hide();
817 mark: function(dropon, position) {
818 // mark on ghosting only
819 var sortable = Sortable.options(dropon.parentNode);
820 if(sortable && !sortable.ghosting) return;
822 if(!Sortable._marker) {
824 ($('dropmarker') || Element.extend(document.createElement('DIV'))).
825 hide().addClassName('dropmarker').setStyle({position:'absolute'});
826 document.getElementsByTagName("body").item(0).appendChild(Sortable._marker);
828 var offsets = Position.cumulativeOffset(dropon);
829 Sortable._marker.setStyle({left: offsets[0]+'px', top: offsets[1] + 'px'});
831 if(position=='after')
832 if(sortable.overlap == 'horizontal')
833 Sortable._marker.setStyle({left: (offsets[0]+dropon.clientWidth) + 'px'});
835 Sortable._marker.setStyle({top: (offsets[1]+dropon.clientHeight) + 'px'});
837 Sortable._marker.show();
840 _tree: function(element, options, parent) {
841 var children = Sortable.findElements(element, options) || [];
843 for (var i = 0; i < children.length; ++i) {
844 var match = children[i].id.match(options.format);
846 if (!match) continue;
849 id: encodeURIComponent(match ? match[1] : null),
853 position: parent.children.length,
854 container: $(children[i]).down(options.treeTag)
857 /* Get the element containing the children and recurse over it */
859 this._tree(child.container, options, child);
861 parent.children.push (child);
867 tree: function(element) {
868 element = $(element);
869 var sortableOptions = this.options(element);
870 var options = Object.extend({
871 tag: sortableOptions.tag,
872 treeTag: sortableOptions.treeTag,
873 only: sortableOptions.only,
875 format: sortableOptions.format
876 }, arguments[1] || { });
886 return Sortable._tree(element, options, root);
889 /* Construct a [i] index for a particular node */
890 _constructIndex: function(node) {
893 if (node.id) index = '[' + node.position + ']' + index;
894 } while ((node = node.parent) != null);
898 sequence: function(element) {
899 element = $(element);
900 var options = Object.extend(this.options(element), arguments[1] || { });
902 return $(this.findElements(element, options) || []).map( function(item) {
903 return item.id.match(options.format) ? item.id.match(options.format)[1] : '';
907 setSequence: function(element, new_sequence) {
908 element = $(element);
909 var options = Object.extend(this.options(element), arguments[2] || { });
912 this.findElements(element, options).each( function(n) {
913 if (n.id.match(options.format))
914 nodeMap[n.id.match(options.format)[1]] = [n, n.parentNode];
915 n.parentNode.removeChild(n);
918 new_sequence.each(function(ident) {
919 var n = nodeMap[ident];
921 n[1].appendChild(n[0]);
922 delete nodeMap[ident];
927 serialize: function(element) {
928 element = $(element);
929 var options = Object.extend(Sortable.options(element), arguments[1] || { });
930 var name = encodeURIComponent(
931 (arguments[1] && arguments[1].name) ? arguments[1].name : element.id);
934 return Sortable.tree(element, arguments[1]).children.map( function (item) {
935 return [name + Sortable._constructIndex(item) + "[id]=" +
936 encodeURIComponent(item.id)].concat(item.children.map(arguments.callee));
937 }).flatten().join('&');
939 return Sortable.sequence(element, arguments[1]).map( function(item) {
940 return name + "[]=" + encodeURIComponent(item);
946 // Returns true if child is contained within element
947 Element.isParent = function(child, element) {
948 if (!child.parentNode || child == element) return false;
949 if (child.parentNode == element) return true;
950 return Element.isParent(child.parentNode, element);
953 Element.findChildren = function(element, only, recursive, tagName) {
954 if(!element.hasChildNodes()) return null;
955 tagName = tagName.toUpperCase();
956 if(only) only = [only].flatten();
958 $A(element.childNodes).each( function(e) {
959 if(e.tagName && e.tagName.toUpperCase()==tagName &&
960 (!only || (Element.classNames(e).detect(function(v) { return only.include(v) }))))
963 var grandchildren = Element.findChildren(e, only, recursive, tagName);
964 if(grandchildren) elements.push(grandchildren);
968 return (elements.length>0 ? elements.flatten() : []);
971 Element.offsetSize = function (element, type) {
972 return element['offset' + ((type=='vertical' || type=='height') ? 'Height' : 'Width')];