4 * Copyright(c) 2006-2007, Ext JS, LLC.
6 * Originally Released Under LGPL - original licence link has changed is not relivant.
9 * <script type="text/javascript">
14 * @class Roo.dd.ScrollManager
15 * Provides automatic scrolling of overflow regions in the page during drag operations.<br><br>
16 * <b>Note: This class uses "Point Mode" and is untested in "Intersect Mode".</b>
19 Roo.dd.ScrollManager = function(){
20 var ddm = Roo.dd.DragDropMgr;
27 var onStop = function(e){
32 var triggerRefresh = function(){
34 ddm.refreshCache(ddm.dragCurrent.groups);
38 var doScroll = function(){
40 var dds = Roo.dd.ScrollManager;
42 if(proc.el.scroll(proc.dir, dds.increment)){
46 proc.el.scroll(proc.dir, dds.increment, true, dds.animDuration, triggerRefresh);
51 var clearProc = function(){
53 clearInterval(proc.id);
60 var startProc = function(el, dir){
61 Roo.log('scroll startproc');
65 proc.id = setInterval(doScroll, Roo.dd.ScrollManager.frequency);
68 var onFire = function(e, isDrop){
70 if(isDrop || !ddm.dragCurrent){ return; }
71 var dds = Roo.dd.ScrollManager;
72 if(!dragEl || dragEl != ddm.dragCurrent){
73 dragEl = ddm.dragCurrent;
74 // refresh regions on drag start
78 var xy = Roo.lib.Event.getXY(e);
79 var pt = new Roo.lib.Point(xy[0], xy[1]);
81 var el = els[id], r = el._region;
82 if(r && r.contains(pt) && el.isScrollable()){
83 if(r.bottom - pt.y <= dds.thresh){
85 startProc(el, "down");
88 }else if(r.right - pt.x <= dds.thresh){
90 startProc(el, "left");
93 }else if(pt.y - r.top <= dds.thresh){
98 }else if(pt.x - r.left <= dds.thresh){
100 startProc(el, "right");
109 ddm.fireEvents = ddm.fireEvents.createSequence(onFire, ddm);
110 ddm.stopDrag = ddm.stopDrag.createSequence(onStop, ddm);
114 * Registers new overflow element(s) to auto scroll
115 * @param {String/HTMLElement/Element/Array} el The id of or the element to be scrolled or an array of either
117 register : function(el){
118 if(el instanceof Array){
119 for(var i = 0, len = el.length; i < len; i++) {
120 this.register(el[i]);
126 Roo.dd.ScrollManager.els = els;
130 * Unregisters overflow element(s) so they are no longer scrolled
131 * @param {String/HTMLElement/Element/Array} el The id of or the element to be removed or an array of either
133 unregister : function(el){
134 if(el instanceof Array){
135 for(var i = 0, len = el.length; i < len; i++) {
136 this.unregister(el[i]);
145 * The number of pixels from the edge of a container the pointer needs to be to
146 * trigger scrolling (defaults to 25)
152 * The number of pixels to scroll in each scroll increment (defaults to 50)
158 * The frequency of scrolls in milliseconds (defaults to 500)
164 * True to animate the scroll (defaults to true)
170 * The animation duration in seconds -
171 * MUST BE less than Roo.dd.ScrollManager.frequency! (defaults to .4)
177 * Manually trigger a cache refresh.
179 refreshCache : function(){
181 if(typeof els[id] == 'object'){ // for people extending the object prototype
182 els[id]._region = els[id].getRegion();