vendor/plugins/rspec/rspec/story_server/prototype/javascripts/dragdrop.js

   1 // script.aculo.us dragdrop.js v1.8.0_pre1, Fri Oct 12 21:34:51 +0200 2007
   2
   3 // Copyright (c) 2005-2007 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
   4 //           (c) 2005-2007 Sammi Williams (http://www.oriontransfer.co.nz, sammi@oriontransfer.co.nz)
   5 //
   6 // script.aculo.us is freely distributable under the terms of an MIT-style license.
   7 // For details, see the script.aculo.us web site: http://script.aculo.us/
   8
   9 if(Object.isUndefined(Effect))
  10   throw("dragdrop.js requires including script.aculo.us' effects.js library");
  11
  12 var Droppables = {
  13   drops: [],
  14
  15   remove: function(element) {
  16     this.drops = this.drops.reject(function(d) { return d.element==$(element) });
  17   },
  18
  19   add: function(element) {
  20     element = $(element);
  21     var options = Object.extend({
  22       greedy:     true,
  23       hoverclass: null,
  24       tree:       false
  25     }, arguments[1] || { });
  26
  27     // cache containers
  28     if(options.containment) {
  29       options._containers = [];
  30       var containment = options.containment;
  31       if(Object.isArray(containment)) {
  32         containment.each( function(c) { options._containers.push($(c)) });
  33       } else {
  34         options._containers.push($(containment));
  35       }
  36     }
  37
  38     if(options.accept) options.accept = [options.accept].flatten();
  39
  40     Element.makePositioned(element); // fix IE
  41     options.element = element;
  42
  43     this.drops.push(options);
  44   },
  45
  46   findDeepestChild: function(drops) {
  47     deepest = drops[0];
  48
  49     for (i = 1; i < drops.length; ++i)
  50       if (Element.isParent(drops[i].element, deepest.element))
  51         deepest = drops[i];
  52
  53     return deepest;
  54   },
  55
  56   isContained: function(element, drop) {
  57     var containmentNode;
  58     if(drop.tree) {
  59       containmentNode = element.treeNode;
  60     } else {
  61       containmentNode = element.parentNode;
  62     }
  63     return drop._containers.detect(function(c) { return containmentNode == c });
  64   },
  65
  66   isAffected: function(point, element, drop) {
  67     return (
  68       (drop.element!=element) &&
  69       ((!drop._containers) ||
  70         this.isContained(element, drop)) &&
  71       ((!drop.accept) ||
  72         (Element.classNames(element).detect(
  73           function(v) { return drop.accept.include(v) } ) )) &&
  74       Position.within(drop.element, point[0], point[1]) );
  75   },
  76
  77   deactivate: function(drop) {
  78     if(drop.hoverclass)
  79       Element.removeClassName(drop.element, drop.hoverclass);
  80     this.last_active = null;
  81   },
  82
  83   activate: function(drop) {
  84     if(drop.hoverclass)
  85       Element.addClassName(drop.element, drop.hoverclass);
  86     this.last_active = drop;
  87   },
  88
  89   show: function(point, element) {
  90     if(!this.drops.length) return;
  91     var drop, affected = [];
  92
  93     this.drops.each( function(drop) {
  94       if(Droppables.isAffected(point, element, drop))
  95         affected.push(drop);
  96     });
  97
  98     if(affected.length>0)
  99       drop = Droppables.findDeepestChild(affected);
 100
 101     if(this.last_active && this.last_active != drop) this.deactivate(this.last_active);
 102     if (drop) {
 103       Position.within(drop.element, point[0], point[1]);
 104       if(drop.onHover)
 105         drop.onHover(element, drop.element, Position.overlap(drop.overlap, drop.element));
 106
 107       if (drop != this.last_active) Droppables.activate(drop);
 108     }
 109   },
 110
 111   fire: function(event, element) {
 112     if(!this.last_active) return;
 113     Position.prepare();
 114
 115     if (this.isAffected([Event.pointerX(event), Event.pointerY(event)], element, this.last_active))
 116       if (this.last_active.onDrop) {
 117         this.last_active.onDrop(element, this.last_active.element, event);
 118         return true;
 119       }
 120   },
 121
 122   reset: function() {
 123     if(this.last_active)
 124       this.deactivate(this.last_active);
 125   }
 126 }
 127
 128 var Draggables = {
 129   drags: [],
 130   observers: [],
 131
 132   register: function(draggable) {
 133     if(this.drags.length == 0) {
 134       this.eventMouseUp   = this.endDrag.bindAsEventListener(this);
 135       this.eventMouseMove = this.updateDrag.bindAsEventListener(this);
 136       this.eventKeypress  = this.keyPress.bindAsEventListener(this);
 137
 138       Event.observe(document, "mouseup", this.eventMouseUp);
 139       Event.observe(document, "mousemove", this.eventMouseMove);
 140       Event.observe(document, "keypress", this.eventKeypress);
 141     }
 142     this.drags.push(draggable);
 143   },
 144
 145   unregister: function(draggable) {
 146     this.drags = this.drags.reject(function(d) { return d==draggable });
 147     if(this.drags.length == 0) {
 148       Event.stopObserving(document, "mouseup", this.eventMouseUp);
 149       Event.stopObserving(document, "mousemove", this.eventMouseMove);
 150       Event.stopObserving(document, "keypress", this.eventKeypress);
 151     }
 152   },
 153
 154   activate: function(draggable) {
 155     if(draggable.options.delay) {
 156       this._timeout = setTimeout(function() {
 157         Draggables._timeout = null;
 158         window.focus();
 159         Draggables.activeDraggable = draggable;
 160       }.bind(this), draggable.options.delay);
 161     } else {
 162       window.focus(); // allows keypress events if window isn't currently focused, fails for Safari
 163       this.activeDraggable = draggable;
 164     }
 165   },
 166
 167   deactivate: function() {
 168     this.activeDraggable = null;
 169   },
 170
 171   updateDrag: function(event) {
 172     if(!this.activeDraggable) return;
 173     var pointer = [Event.pointerX(event), Event.pointerY(event)];
 174     // Mozilla-based browsers fire successive mousemove events with
 175     // the same coordinates, prevent needless redrawing (moz bug?)
 176     if(this._lastPointer && (this._lastPointer.inspect() == pointer.inspect())) return;
 177     this._lastPointer = pointer;
 178
 179     this.activeDraggable.updateDrag(event, pointer);
 180   },
 181
 182   endDrag: function(event) {
 183     if(this._timeout) {
 184       clearTimeout(this._timeout);
 185       this._timeout = null;
 186     }
 187     if(!this.activeDraggable) return;
 188     this._lastPointer = null;
 189     this.activeDraggable.endDrag(event);
 190     this.activeDraggable = null;
 191   },
 192
 193   keyPress: function(event) {
 194     if(this.activeDraggable)
 195       this.activeDraggable.keyPress(event);
 196   },
 197
 198   addObserver: function(observer) {
 199     this.observers.push(observer);
 200     this._cacheObserverCallbacks();
 201   },
 202
 203   removeObserver: function(element) {  // element instead of observer fixes mem leaks
 204     this.observers = this.observers.reject( function(o) { return o.element==element });
 205     this._cacheObserverCallbacks();
 206   },
 207
 208   notify: function(eventName, draggable, event) {  // 'onStart', 'onEnd', 'onDrag'
 209     if(this[eventName+'Count'] > 0)
 210       this.observers.each( function(o) {
 211         if(o[eventName]) o[eventName](eventName, draggable, event);
 212       });
 213     if(draggable.options[eventName]) draggable.options[eventName](draggable, event);
 214   },
 215
 216   _cacheObserverCallbacks: function() {
 217     ['onStart','onEnd','onDrag'].each( function(eventName) {
 218       Draggables[eventName+'Count'] = Draggables.observers.select(
 219         function(o) { return o[eventName]; }
 220       ).length;
 221     });
 222   }
 223 }
 224
 225 /*--------------------------------------------------------------------------*/
 226
 227 var Draggable = Class.create();
 228 Draggable._dragging    = { };
 229
 230 Draggable.prototype = {
 231   initialize: function(element) {
 232     var defaults = {
 233       handle: false,
 234       reverteffect: function(element, top_offset, left_offset) {
 235         var dur = Math.sqrt(Math.abs(top_offset^2)+Math.abs(left_offset^2))*0.02;
 236         new Effect.Move(element, { x: -left_offset, y: -top_offset, duration: dur,
 237           queue: {scope:'_draggable', position:'end'}
 238         });
 239       },
 240       endeffect: function(element) {
 241         var toOpacity = Object.isNumber(element._opacity) ? element._opacity : 1.0;
 242         new Effect.Opacity(element, {duration:0.2, from:0.7, to:toOpacity,
 243           queue: {scope:'_draggable', position:'end'},
 244           afterFinish: function(){
 245             Draggable._dragging[element] = false
 246           }
 247         });
 248       },
 249       zindex: 1000,
 250       revert: false,
 251       quiet: false,
 252       scroll: false,
 253       scrollSensitivity: 20,
 254       scrollSpeed: 15,
 255       snap: false,  // false, or xy or [x,y] or function(x,y){ return [x,y] }
 256       delay: 0
 257     };
 258
 259     if(!arguments[1] || Object.isUndefined(arguments[1].endeffect))
 260       Object.extend(defaults, {
 261         starteffect: function(element) {
 262           element._opacity = Element.getOpacity(element);
 263           Draggable._dragging[element] = true;
 264           new Effect.Opacity(element, {duration:0.2, from:element._opacity, to:0.7});
 265         }
 266       });
 267
 268     var options = Object.extend(defaults, arguments[1] || { });
 269
 270     this.element = $(element);
 271
 272     if(options.handle && Object.isString(options.handle))
 273       this.handle = this.element.down('.'+options.handle, 0);
 274
 275     if(!this.handle) this.handle = $(options.handle);
 276     if(!this.handle) this.handle = this.element;
 277
 278     if(options.scroll && !options.scroll.scrollTo && !options.scroll.outerHTML) {
 279       options.scroll = $(options.scroll);
 280       this._isScrollChild = Element.childOf(this.element, options.scroll);
 281     }
 282
 283     Element.makePositioned(this.element); // fix IE
 284
 285     this.options  = options;
 286     this.dragging = false;
 287
 288     this.eventMouseDown = this.initDrag.bindAsEventListener(this);
 289     Event.observe(this.handle, "mousedown", this.eventMouseDown);
 290
 291     Draggables.register(this);
 292   },
 293
 294   destroy: function() {
 295     Event.stopObserving(this.handle, "mousedown", this.eventMouseDown);
 296     Draggables.unregister(this);
 297   },
 298
 299   currentDelta: function() {
 300     return([
 301       parseInt(Element.getStyle(this.element,'left') || '0'),
 302       parseInt(Element.getStyle(this.element,'top') || '0')]);
 303   },
 304
 305   initDrag: function(event) {
 306     if(!Object.isUndefined(Draggable._dragging[this.element]) &&
 307       Draggable._dragging[this.element]) return;
 308     if(Event.isLeftClick(event)) {
 309       // abort on form elements, fixes a Firefox issue
 310       var src = Event.element(event);
 311       if((tag_name = src.tagName.toUpperCase()) && (
 312         tag_name=='INPUT' ||
 313         tag_name=='SELECT' ||
 314         tag_name=='OPTION' ||
 315         tag_name=='BUTTON' ||
 316         tag_name=='TEXTAREA')) return;
 317
 318       var pointer = [Event.pointerX(event), Event.pointerY(event)];
 319       var pos     = Position.cumulativeOffset(this.element);
 320       this.offset = [0,1].map( function(i) { return (pointer[i] - pos[i]) });
 321
 322       Draggables.activate(this);
 323       Event.stop(event);
 324     }
 325   },
 326
 327   startDrag: function(event) {
 328     this.dragging = true;
 329     if(!this.delta)
 330       this.delta = this.currentDelta();
 331
 332     if(this.options.zindex) {
 333       this.originalZ = parseInt(Element.getStyle(this.element,'z-index') || 0);
 334       this.element.style.zIndex = this.options.zindex;
 335     }
 336
 337     if(this.options.ghosting) {
 338       this._clone = this.element.cloneNode(true);
 339       this.element._originallyAbsolute = (this.element.getStyle('position') == 'absolute');
 340       if (!this.element._originallyAbsolute)
 341         Position.absolutize(this.element);
 342       this.element.parentNode.insertBefore(this._clone, this.element);
 343     }
 344
 345     if(this.options.scroll) {
 346       if (this.options.scroll == window) {
 347         var where = this._getWindowScroll(this.options.scroll);
 348         this.originalScrollLeft = where.left;
 349         this.originalScrollTop = where.top;
 350       } else {
 351         this.originalScrollLeft = this.options.scroll.scrollLeft;
 352         this.originalScrollTop = this.options.scroll.scrollTop;
 353       }
 354     }
 355
 356     Draggables.notify('onStart', this, event);
 357
 358     if(this.options.starteffect) this.options.starteffect(this.element);
 359   },
 360
 361   updateDrag: function(event, pointer) {
 362     if(!this.dragging) this.startDrag(event);
 363
 364     if(!this.options.quiet){
 365       Position.prepare();
 366       Droppables.show(pointer, this.element);
 367     }
 368
 369     Draggables.notify('onDrag', this, event);
 370
 371     this.draw(pointer);
 372     if(this.options.change) this.options.change(this);
 373
 374     if(this.options.scroll) {
 375       this.stopScrolling();
 376
 377       var p;
 378       if (this.options.scroll == window) {
 379         with(this._getWindowScroll(this.options.scroll)) { p = [ left, top, left+width, top+height ]; }
 380       } else {
 381         p = Position.page(this.options.scroll);
 382         p[0] += this.options.scroll.scrollLeft + Position.deltaX;
 383         p[1] += this.options.scroll.scrollTop + Position.deltaY;
 384         p.push(p[0]+this.options.scroll.offsetWidth);
 385         p.push(p[1]+this.options.scroll.offsetHeight);
 386       }
 387       var speed = [0,0];
 388       if(pointer[0] < (p[0]+this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[0]+this.options.scrollSensitivity);
 389       if(pointer[1] < (p[1]+this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[1]+this.options.scrollSensitivity);
 390       if(pointer[0] > (p[2]-this.options.scrollSensitivity)) speed[0] = pointer[0]-(p[2]-this.options.scrollSensitivity);
 391       if(pointer[1] > (p[3]-this.options.scrollSensitivity)) speed[1] = pointer[1]-(p[3]-this.options.scrollSensitivity);
 392       this.startScrolling(speed);
 393     }
 394
 395     // fix AppleWebKit rendering
 396     if(Prototype.Browser.WebKit) window.scrollBy(0,0);
 397
 398     Event.stop(event);
 399   },
 400
 401   finishDrag: function(event, success) {
 402     this.dragging = false;
 403
 404     if(this.options.quiet){
 405       Position.prepare();
 406       var pointer = [Event.pointerX(event), Event.pointerY(event)];
 407       Droppables.show(pointer, this.element);
 408     }
 409
 410     if(this.options.ghosting) {
 411       if (!this.element._originallyAbsolute)
 412         Position.relativize(this.element);
 413       delete this.element._originallyAbsolute;
 414       Element.remove(this._clone);
 415       this._clone = null;
 416     }
 417
 418     var dropped = false;
 419     if(success) {
 420       dropped = Droppables.fire(event, this.element);
 421       if (!dropped) dropped = false;
 422     }
 423     if(dropped && this.options.onDropped) this.options.onDropped(this.element);
 424     Draggables.notify('onEnd', this, event);
 425
 426     var revert = this.options.revert;
 427     if(revert && Object.isFunction(revert)) revert = revert(this.element);
 428
 429     var d = this.currentDelta();
 430     if(revert && this.options.reverteffect) {
 431       if (dropped == 0 || revert != 'failure')
 432         this.options.reverteffect(this.element,
 433           d[1]-this.delta[1], d[0]-this.delta[0]);
 434     } else {
 435       this.delta = d;
 436     }
 437
 438     if(this.options.zindex)
 439       this.element.style.zIndex = this.originalZ;
 440
 441     if(this.options.endeffect)
 442       this.options.endeffect(this.element);
 443
 444     Draggables.deactivate(this);
 445     Droppables.reset();
 446   },
 447
 448   keyPress: function(event) {
 449     if(event.keyCode!=Event.KEY_ESC) return;
 450     this.finishDrag(event, false);
 451     Event.stop(event);
 452   },
 453
 454   endDrag: function(event) {
 455     if(!this.dragging) return;
 456     this.stopScrolling();
 457     this.finishDrag(event, true);
 458     Event.stop(event);
 459   },
 460
 461   draw: function(point) {
 462     var pos = Position.cumulativeOffset(this.element);
 463     if(this.options.ghosting) {
 464       var r   = Position.realOffset(this.element);
 465       pos[0] += r[0] - Position.deltaX; pos[1] += r[1] - Position.deltaY;
 466     }
 467
 468     var d = this.currentDelta();
 469     pos[0] -= d[0]; pos[1] -= d[1];
 470
 471     if(this.options.scroll && (this.options.scroll != window && this._isScrollChild)) {
 472       pos[0] -= this.options.scroll.scrollLeft-this.originalScrollLeft;
 473       pos[1] -= this.options.scroll.scrollTop-this.originalScrollTop;
 474     }
 475
 476     var p = [0,1].map(function(i){
 477       return (point[i]-pos[i]-this.offset[i])
 478     }.bind(this));
 479
 480     if(this.options.snap) {
 481       if(Object.isFunction(this.options.snap)) {
 482         p = this.options.snap(p[0],p[1],this);
 483       } else {
 484       if(Object.isArray(this.options.snap)) {
 485         p = p.map( function(v, i) {
 486           return (v/this.options.snap[i]).round()*this.options.snap[i] }.bind(this))
 487       } else {
 488         p = p.map( function(v) {
 489           return (v/this.options.snap).round()*this.options.snap }.bind(this))
 490       }
 491     }}
 492
 493     var style = this.element.style;
 494     if((!this.options.constraint) || (this.options.constraint=='horizontal'))
 495       style.left = p[0] + "px";
 496     if((!this.options.constraint) || (this.options.constraint=='vertical'))
 497       style.top  = p[1] + "px";
 498
 499     if(style.visibility=="hidden") style.visibility = ""; // fix gecko rendering
 500   },
 501
 502   stopScrolling: function() {
 503     if(this.scrollInterval) {
 504       clearInterval(this.scrollInterval);
 505       this.scrollInterval = null;
 506       Draggables._lastScrollPointer = null;
 507     }
 508   },
 509
 510   startScrolling: function(speed) {
 511     if(!(speed[0] || speed[1])) return;
 512     this.scrollSpeed = [speed[0]*this.options.scrollSpeed,speed[1]*this.options.scrollSpeed];
 513     this.lastScrolled = new Date();
 514     this.scrollInterval = setInterval(this.scroll.bind(this), 10);
 515   },
 516
 517   scroll: function() {
 518     var current = new Date();
 519     var delta = current - this.lastScrolled;
 520     this.lastScrolled = current;
 521     if(this.options.scroll == window) {
 522       with (this._getWindowScroll(this.options.scroll)) {
 523         if (this.scrollSpeed[0] || this.scrollSpeed[1]) {
 524           var d = delta / 1000;
 525           this.options.scroll.scrollTo( left + d*this.scrollSpeed[0], top + d*this.scrollSpeed[1] );
 526         }
 527       }
 528     } else {
 529       this.options.scroll.scrollLeft += this.scrollSpeed[0] * delta / 1000;
 530       this.options.scroll.scrollTop  += this.scrollSpeed[1] * delta / 1000;
 531     }
 532
 533     Position.prepare();
 534     Droppables.show(Draggables._lastPointer, this.element);
 535     Draggables.notify('onDrag', this);
 536     if (this._isScrollChild) {
 537       Draggables._lastScrollPointer = Draggables._lastScrollPointer || $A(Draggables._lastPointer);
 538       Draggables._lastScrollPointer[0] += this.scrollSpeed[0] * delta / 1000;
 539       Draggables._lastScrollPointer[1] += this.scrollSpeed[1] * delta / 1000;
 540       if (Draggables._lastScrollPointer[0] < 0)
 541         Draggables._lastScrollPointer[0] = 0;
 542       if (Draggables._lastScrollPointer[1] < 0)
 543         Draggables._lastScrollPointer[1] = 0;
 544       this.draw(Draggables._lastScrollPointer);
 545     }
 546
 547     if(this.options.change) this.options.change(this);
 548   },
 549
 550   _getWindowScroll: function(w) {
 551     var T, L, W, H;
 552     with (w.document) {
 553       if (w.document.documentElement && documentElement.scrollTop) {
 554         T = documentElement.scrollTop;
 555         L = documentElement.scrollLeft;
 556       } else if (w.document.body) {
 557         T = body.scrollTop;
 558         L = body.scrollLeft;
 559       }
 560       if (w.innerWidth) {
 561         W = w.innerWidth;
 562         H = w.innerHeight;
 563       } else if (w.document.documentElement && documentElement.clientWidth) {
 564         W = documentElement.clientWidth;
 565         H = documentElement.clientHeight;
 566       } else {
 567         W = body.offsetWidth;
 568         H = body.offsetHeight
 569       }
 570     }
 571     return { top: T, left: L, width: W, height: H };
 572   }
 573 }
 574
 575 /*--------------------------------------------------------------------------*/
 576
 577 var SortableObserver = Class.create();
 578 SortableObserver.prototype = {
 579   initialize: function(element, observer) {
 580     this.element   = $(element);
 581     this.observer  = observer;
 582     this.lastValue = Sortable.serialize(this.element);
 583   },
 584
 585   onStart: function() {
 586     this.lastValue = Sortable.serialize(this.element);
 587   },
 588
 589   onEnd: function() {
 590     Sortable.unmark();
 591     if(this.lastValue != Sortable.serialize(this.element))
 592       this.observer(this.element)
 593   }
 594 }
 595
 596 var Sortable = {
 597   SERIALIZE_RULE: /^[^_\-](?:[A-Za-z0-9\-\_]*)[_](.*)$/,
 598
 599   sortables: { },
 600
 601   _findRootElement: function(element) {
 602     while (element.tagName.toUpperCase() != "BODY") {
 603       if(element.id && Sortable.sortables[element.id]) return element;
 604       element = element.parentNode;
 605     }
 606   },
 607
 608   options: function(element) {
 609     element = Sortable._findRootElement($(element));
 610     if(!element) return;
 611     return Sortable.sortables[element.id];
 612   },
 613
 614   destroy: function(element){
 615     var s = Sortable.options(element);
 616
 617     if(s) {
 618       Draggables.removeObserver(s.element);
 619       s.droppables.each(function(d){ Droppables.remove(d) });
 620       s.draggables.invoke('destroy');
 621
 622       delete Sortable.sortables[s.element.id];
 623     }
 624   },
 625
 626   create: function(element) {
 627     element = $(element);
 628     var options = Object.extend({
 629       element:     element,
 630       tag:         'li',       // assumes li children, override with tag: 'tagname'
 631       dropOnEmpty: false,
 632       tree:        false,
 633       treeTag:     'ul',
 634       overlap:     'vertical', // one of 'vertical', 'horizontal'
 635       constraint:  'vertical', // one of 'vertical', 'horizontal', false
 636       containment: element,    // also takes array of elements (or id's); or false
 637       handle:      false,      // or a CSS class
 638       only:        false,
 639       delay:       0,
 640       hoverclass:  null,
 641       ghosting:    false,
 642       quiet:       false,
 643       scroll:      false,
 644       scrollSensitivity: 20,
 645       scrollSpeed: 15,
 646       format:      this.SERIALIZE_RULE,
 647
 648       // these take arrays of elements or ids and can be
 649       // used for better initialization performance
 650       elements:    false,
 651       handles:     false,
 652
 653       onChange:    Prototype.emptyFunction,
 654       onUpdate:    Prototype.emptyFunction
 655     }, arguments[1] || { });
 656
 657     // clear any old sortable with same element
 658     this.destroy(element);
 659
 660     // build options for the draggables
 661     var options_for_draggable = {
 662       revert:      true,
 663       quiet:       options.quiet,
 664       scroll:      options.scroll,
 665       scrollSpeed: options.scrollSpeed,
 666       scrollSensitivity: options.scrollSensitivity,
 667       delay:       options.delay,
 668       ghosting:    options.ghosting,
 669       constraint:  options.constraint,
 670       handle:      options.handle };
 671
 672     if(options.starteffect)
 673       options_for_draggable.starteffect = options.starteffect;
 674
 675     if(options.reverteffect)
 676       options_for_draggable.reverteffect = options.reverteffect;
 677     else
 678       if(options.ghosting) options_for_draggable.reverteffect = function(element) {
 679         element.style.top  = 0;
 680         element.style.left = 0;
 681       };
 682
 683     if(options.endeffect)
 684       options_for_draggable.endeffect = options.endeffect;
 685
 686     if(options.zindex)
 687       options_for_draggable.zindex = options.zindex;
 688
 689     // build options for the droppables
 690     var options_for_droppable = {
 691       overlap:     options.overlap,
 692       containment: options.containment,
 693       tree:        options.tree,
 694       hoverclass:  options.hoverclass,
 695       onHover:     Sortable.onHover
 696     }
 697
 698     var options_for_tree = {
 699       onHover:      Sortable.onEmptyHover,
 700       overlap:      options.overlap,
 701       containment:  options.containment,
 702       hoverclass:   options.hoverclass
 703     }
 704
 705     // fix for gecko engine
 706     Element.cleanWhitespace(element);
 707
 708     options.draggables = [];
 709     options.droppables = [];
 710
 711     // drop on empty handling
 712     if(options.dropOnEmpty || options.tree) {
 713       Droppables.add(element, options_for_tree);
 714       options.droppables.push(element);
 715     }
 716
 717     (options.elements || this.findElements(element, options) || []).each( function(e,i) {
 718       var handle = options.handles ? $(options.handles[i]) :
 719         (options.handle ? $(e).getElementsByClassName(options.handle)[0] : e);
 720       options.draggables.push(
 721         new Draggable(e, Object.extend(options_for_draggable, { handle: handle })));
 722       Droppables.add(e, options_for_droppable);
 723       if(options.tree) e.treeNode = element;
 724       options.droppables.push(e);
 725     });
 726
 727     if(options.tree) {
 728       (Sortable.findTreeElements(element, options) || []).each( function(e) {
 729         Droppables.add(e, options_for_tree);
 730         e.treeNode = element;
 731         options.droppables.push(e);
 732       });
 733     }
 734
 735     // keep reference
 736     this.sortables[element.id] = options;
 737
 738     // for onupdate
 739     Draggables.addObserver(new SortableObserver(element, options.onUpdate));
 740
 741   },
 742
 743   // return all suitable-for-sortable elements in a guaranteed order
 744   findElements: function(element, options) {
 745     return Element.findChildren(
 746       element, options.only, options.tree ? true : false, options.tag);
 747   },
 748
 749   findTreeElements: function(element, options) {
 750     return Element.findChildren(
 751       element, options.only, options.tree ? true : false, options.treeTag);
 752   },
 753
 754   onHover: function(element, dropon, overlap) {
 755     if(Element.isParent(dropon, element)) return;
 756
 757     if(overlap > .33 && overlap < .66 && Sortable.options(dropon).tree) {
 758       return;
 759     } else if(overlap>0.5) {
 760       Sortable.mark(dropon, 'before');
 761       if(dropon.previousSibling != element) {
 762         var oldParentNode = element.parentNode;
 763         element.style.visibility = "hidden"; // fix gecko rendering
 764         dropon.parentNode.insertBefore(element, dropon);
 765         if(dropon.parentNode!=oldParentNode)
 766           Sortable.options(oldParentNode).onChange(element);
 767         Sortable.options(dropon.parentNode).onChange(element);
 768       }
 769     } else {
 770       Sortable.mark(dropon, 'after');
 771       var nextElement = dropon.nextSibling || null;
 772       if(nextElement != element) {
 773         var oldParentNode = element.parentNode;
 774         element.style.visibility = "hidden"; // fix gecko rendering
 775         dropon.parentNode.insertBefore(element, nextElement);
 776         if(dropon.parentNode!=oldParentNode)
 777           Sortable.options(oldParentNode).onChange(element);
 778         Sortable.options(dropon.parentNode).onChange(element);
 779       }
 780     }
 781   },
 782
 783   onEmptyHover: function(element, dropon, overlap) {
 784     var oldParentNode = element.parentNode;
 785     var droponOptions = Sortable.options(dropon);
 786
 787     if(!Element.isParent(dropon, element)) {
 788       var index;
 789
 790       var children = Sortable.findElements(dropon, {tag: droponOptions.tag, only: droponOptions.only});
 791       var child = null;
 792
 793       if(children) {
 794         var offset = Element.offsetSize(dropon, droponOptions.overlap) * (1.0 - overlap);
 795
 796         for (index = 0; index < children.length; index += 1) {
 797           if (offset - Element.offsetSize (children[index], droponOptions.overlap) >= 0) {
 798             offset -= Element.offsetSize (children[index], droponOptions.overlap);
 799           } else if (offset - (Element.offsetSize (children[index], droponOptions.overlap) / 2) >= 0) {
 800             child = index + 1 < children.length ? children[index + 1] : null;
 801             break;
 802           } else {
 803             child = children[index];
 804             break;
 805           }
 806         }
 807       }
 808
 809       dropon.insertBefore(element, child);
 810
 811       Sortable.options(oldParentNode).onChange(element);
 812       droponOptions.onChange(element);
 813     }
 814   },
 815
 816   unmark: function() {
 817     if(Sortable._marker) Sortable._marker.hide();
 818   },
 819
 820   mark: function(dropon, position) {
 821     // mark on ghosting only
 822     var sortable = Sortable.options(dropon.parentNode);
 823     if(sortable && !sortable.ghosting) return;
 824
 825     if(!Sortable._marker) {
 826       Sortable._marker =
 827         ($('dropmarker') || Element.extend(document.createElement('DIV'))).
 828           hide().addClassName('dropmarker').setStyle({position:'absolute'});
 829       document.getElementsByTagName("body").item(0).appendChild(Sortable._marker);
 830     }
 831     var offsets = Position.cumulativeOffset(dropon);
 832     Sortable._marker.setStyle({left: offsets[0]+'px', top: offsets[1] + 'px'});
 833
 834     if(position=='after')
 835       if(sortable.overlap == 'horizontal')
 836         Sortable._marker.setStyle({left: (offsets[0]+dropon.clientWidth) + 'px'});
 837       else
 838         Sortable._marker.setStyle({top: (offsets[1]+dropon.clientHeight) + 'px'});
 839
 840     Sortable._marker.show();
 841   },
 842
 843   _tree: function(element, options, parent) {
 844     var children = Sortable.findElements(element, options) || [];
 845
 846     for (var i = 0; i < children.length; ++i) {
 847       var match = children[i].id.match(options.format);
 848
 849       if (!match) continue;
 850
 851       var child = {
 852         id: encodeURIComponent(match ? match[1] : null),
 853         element: element,
 854         parent: parent,
 855         children: [],
 856         position: parent.children.length,
 857         container: $(children[i]).down(options.treeTag)
 858       }
 859
 860       /* Get the element containing the children and recurse over it */
 861       if (child.container)
 862         this._tree(child.container, options, child)
 863
 864       parent.children.push (child);
 865     }
 866
 867     return parent;
 868   },
 869
 870   tree: function(element) {
 871     element = $(element);
 872     var sortableOptions = this.options(element);
 873     var options = Object.extend({
 874       tag: sortableOptions.tag,
 875       treeTag: sortableOptions.treeTag,
 876       only: sortableOptions.only,
 877       name: element.id,
 878       format: sortableOptions.format
 879     }, arguments[1] || { });
 880
 881     var root = {
 882       id: null,
 883       parent: null,
 884       children: [],
 885       container: element,
 886       position: 0
 887     }
 888
 889     return Sortable._tree(element, options, root);
 890   },
 891
 892   /* Construct a [i] index for a particular node */
 893   _constructIndex: function(node) {
 894     var index = '';
 895     do {
 896       if (node.id) index = '[' + node.position + ']' + index;
 897     } while ((node = node.parent) != null);
 898     return index;
 899   },
 900
 901   sequence: function(element) {
 902     element = $(element);
 903     var options = Object.extend(this.options(element), arguments[1] || { });
 904
 905     return $(this.findElements(element, options) || []).map( function(item) {
 906       return item.id.match(options.format) ? item.id.match(options.format)[1] : '';
 907     });
 908   },
 909
 910   setSequence: function(element, new_sequence) {
 911     element = $(element);
 912     var options = Object.extend(this.options(element), arguments[2] || { });
 913
 914     var nodeMap = { };
 915     this.findElements(element, options).each( function(n) {
 916         if (n.id.match(options.format))
 917             nodeMap[n.id.match(options.format)[1]] = [n, n.parentNode];
 918         n.parentNode.removeChild(n);
 919     });
 920
 921     new_sequence.each(function(ident) {
 922       var n = nodeMap[ident];
 923       if (n) {
 924         n[1].appendChild(n[0]);
 925         delete nodeMap[ident];
 926       }
 927     });
 928   },
 929
 930   serialize: function(element) {
 931     element = $(element);
 932     var options = Object.extend(Sortable.options(element), arguments[1] || { });
 933     var name = encodeURIComponent(
 934       (arguments[1] && arguments[1].name) ? arguments[1].name : element.id);
 935
 936     if (options.tree) {
 937       return Sortable.tree(element, arguments[1]).children.map( function (item) {
 938         return [name + Sortable._constructIndex(item) + "[id]=" +
 939                 encodeURIComponent(item.id)].concat(item.children.map(arguments.callee));
 940       }).flatten().join('&');
 941     } else {
 942       return Sortable.sequence(element, arguments[1]).map( function(item) {
 943         return name + "[]=" + encodeURIComponent(item);
 944       }).join('&');
 945     }
 946   }
 947 }
 948
 949 // Returns true if child is contained within element
 950 Element.isParent = function(child, element) {
 951   if (!child.parentNode || child == element) return false;
 952   if (child.parentNode == element) return true;
 953   return Element.isParent(child.parentNode, element);
 954 }
 955
 956 Element.findChildren = function(element, only, recursive, tagName) {
 957   if(!element.hasChildNodes()) return null;
 958   tagName = tagName.toUpperCase();
 959   if(only) only = [only].flatten();
 960   var elements = [];
 961   $A(element.childNodes).each( function(e) {
 962     if(e.tagName && e.tagName.toUpperCase()==tagName &&
 963       (!only || (Element.classNames(e).detect(function(v) { return only.include(v) }))))
 964         elements.push(e);
 965     if(recursive) {
 966       var grandchildren = Element.findChildren(e, only, recursive, tagName);
 967       if(grandchildren) elements.push(grandchildren);
 968     }
 969   });
 970
 971   return (elements.length>0 ? elements.flatten() : []);
 972 }
 973
 974 Element.offsetSize = function (element, type) {
 975   return element['offset' + ((type=='vertical' || type=='height') ? 'Height' : 'Width')];
 976 }