3 <title>The source code</title>
4 <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
5 <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
7 <body onload="prettyPrint();">
8 <pre class="prettyprint lang-js">/*!
10 * Copyright(c) 2006-2009 Ext JS, LLC
12 * http://www.extjs.com/license
14 <div id="cls-Ext.dd.ScrollManager"></div>/**
\r
15 * @class Ext.dd.ScrollManager
\r
16 * <p>Provides automatic scrolling of overflow regions in the page during drag operations.</p>
\r
17 * <p>The ScrollManager configs will be used as the defaults for any scroll container registered with it,
\r
18 * but you can also override most of the configs per scroll container by adding a
\r
19 * <tt>ddScrollConfig</tt> object to the target element that contains these properties: {@link #hthresh},
\r
20 * {@link #vthresh}, {@link #increment} and {@link #frequency}. Example usage:
\r
22 var el = Ext.get('scroll-ct');
\r
23 el.ddScrollConfig = {
\r
29 Ext.dd.ScrollManager.register(el);
\r
31 * <b>Note: This class uses "Point Mode" and is untested in "Intersect Mode".</b>
\r
34 Ext.dd.ScrollManager = function(){
\r
35 var ddm = Ext.dd.DragDropMgr;
\r
40 var onStop = function(e){
\r
45 var triggerRefresh = function(){
\r
46 if(ddm.dragCurrent){
\r
47 ddm.refreshCache(ddm.dragCurrent.groups);
\r
51 var doScroll = function(){
\r
52 if(ddm.dragCurrent){
\r
53 var dds = Ext.dd.ScrollManager;
\r
54 var inc = proc.el.ddScrollConfig ?
\r
55 proc.el.ddScrollConfig.increment : dds.increment;
\r
57 if(proc.el.scroll(proc.dir, inc)){
\r
61 proc.el.scroll(proc.dir, inc, true, dds.animDuration, triggerRefresh);
\r
66 var clearProc = function(){
\r
68 clearInterval(proc.id);
\r
75 var startProc = function(el, dir){
\r
79 var freq = (el.ddScrollConfig && el.ddScrollConfig.frequency) ?
\r
80 el.ddScrollConfig.frequency : Ext.dd.ScrollManager.frequency;
\r
81 proc.id = setInterval(doScroll, freq);
\r
84 var onFire = function(e, isDrop){
\r
85 if(isDrop || !ddm.dragCurrent){ return; }
\r
86 var dds = Ext.dd.ScrollManager;
\r
87 if(!dragEl || dragEl != ddm.dragCurrent){
\r
88 dragEl = ddm.dragCurrent;
\r
89 // refresh regions on drag start
\r
93 var xy = Ext.lib.Event.getXY(e);
\r
94 var pt = new Ext.lib.Point(xy[0], xy[1]);
\r
96 var el = els[id], r = el._region;
\r
97 var c = el.ddScrollConfig ? el.ddScrollConfig : dds;
\r
98 if(r && r.contains(pt) && el.isScrollable()){
\r
99 if(r.bottom - pt.y <= c.vthresh){
\r
101 startProc(el, "down");
\r
104 }else if(r.right - pt.x <= c.hthresh){
\r
106 startProc(el, "left");
\r
109 }else if(pt.y - r.top <= c.vthresh){
\r
111 startProc(el, "up");
\r
114 }else if(pt.x - r.left <= c.hthresh){
\r
116 startProc(el, "right");
\r
125 ddm.fireEvents = ddm.fireEvents.createSequence(onFire, ddm);
\r
126 ddm.stopDrag = ddm.stopDrag.createSequence(onStop, ddm);
\r
129 <div id="method-Ext.dd.ScrollManager-register"></div>/**
\r
130 * Registers new overflow element(s) to auto scroll
\r
131 * @param {Mixed/Array} el The id of or the element to be scrolled or an array of either
\r
133 register : function(el){
\r
134 if(Ext.isArray(el)){
\r
135 for(var i = 0, len = el.length; i < len; i++) {
\r
136 this.register(el[i]);
\r
144 <div id="method-Ext.dd.ScrollManager-unregister"></div>/**
\r
145 * Unregisters overflow element(s) so they are no longer scrolled
\r
146 * @param {Mixed/Array} el The id of or the element to be removed or an array of either
\r
148 unregister : function(el){
\r
149 if(Ext.isArray(el)){
\r
150 for(var i = 0, len = el.length; i < len; i++) {
\r
151 this.unregister(el[i]);
\r
159 <div id="prop-Ext.dd.ScrollManager-vthresh"></div>/**
\r
160 * The number of pixels from the top or bottom edge of a container the pointer needs to be to
\r
161 * trigger scrolling (defaults to 25)
\r
165 <div id="prop-Ext.dd.ScrollManager-hthresh"></div>/**
\r
166 * The number of pixels from the right or left edge of a container the pointer needs to be to
\r
167 * trigger scrolling (defaults to 25)
\r
172 <div id="prop-Ext.dd.ScrollManager-increment"></div>/**
\r
173 * The number of pixels to scroll in each scroll increment (defaults to 50)
\r
178 <div id="prop-Ext.dd.ScrollManager-frequency"></div>/**
\r
179 * The frequency of scrolls in milliseconds (defaults to 500)
\r
184 <div id="prop-Ext.dd.ScrollManager-animate"></div>/**
\r
185 * True to animate the scroll (defaults to true)
\r
190 <div id="prop-Ext.dd.ScrollManager-animDuration"></div>/**
\r
191 * The animation duration in seconds -
\r
192 * MUST BE less than Ext.dd.ScrollManager.frequency! (defaults to .4)
\r
197 <div id="method-Ext.dd.ScrollManager-refreshCache"></div>/**
\r
198 * Manually trigger a cache refresh.
\r
200 refreshCache : function(){
\r
201 for(var id in els){
\r
202 if(typeof els[id] == 'object'){ // for people extending the object prototype
\r
203 els[id]._region = els[id].getRegion();
\r