PageRenderTime 66ms CodeModel.GetById 23ms RepoModel.GetById 0ms app.codeStats 0ms

/VivoWebControls/sencha-touch-1.1.1/docs/source/Element.alignment.html

#
HTML | 366 lines | 346 code | 20 blank | 0 comment | 0 complexity | 2b3443dddf2cd817fad7ec45b6730a99 MD5 | raw file
Possible License(s): LGPL-3.0 
    

  1. <html>
    2. 

  2. <head>
    3. 

  3.   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
    4. 

  4.   <title>The source code</title>
    5. 

  5.     <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
    6. 

  6.     <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
    7. 

  7. </head>
    8. 

  8. <body  onload="prettyPrint();">
    9. 

  9.     <pre class="prettyprint lang-js">/**
    10. 

  10.  * @class Ext.Element
    11. 

  11.  */
    12. 

  12. Ext.Element.addMethods({
    13. 

  13.     <div id="method-Ext.Element-getAnchorXY"></div>/**
    14. 

  14.      * Gets the x,y coordinates specified by the anchor position on the element.
    15. 

  15.      * @param {String} anchor (optional) The specified anchor position (defaults to "c").  See {@link #alignTo}
    16. 

  16.      * for details on supported anchor positions.
    17. 

  17.      * @param {Object} size (optional) An object containing the size to use for calculating anchor position
    18. 

  18.      * {width: (target width), height: (target height)} (defaults to the element's current size)
    19. 

  19.      * @return {Array} [x, y] An array containing the element's x and y coordinates
    20. 

  20.      */
    21. 

  21.     getAnchorXY: function(anchor, local, size) {
    22. 

  22.         //Passing a different size is useful for pre-calculating anchors,
    23. 

  23.         //especially for anchored animations that change the el size.
    24. 

  24.         anchor = (anchor || "tl").toLowerCase();
    25. 

  25.         size = size || {};
    26. 

  26. 

  27.         var me = this,
    28. 

  28.             vp = me.dom == document.body || me.dom == document,
    29. 

  29.             width = size.width || vp ? window.innerWidth: me.getWidth(),
    30. 

  30.             height = size.height || vp ? window.innerHeight: me.getHeight(),
    31. 

  31.             xy,
    32. 

  32.             rnd = Math.round,
    33. 

  33.             myXY = me.getXY(),
    34. 

  34.             extraX = vp ? 0: !local ? myXY[0] : 0,
    35. 

  35.             extraY = vp ? 0: !local ? myXY[1] : 0,
    36. 

  36.             hash = {
    37. 

  37.                 c: [rnd(width * 0.5), rnd(height * 0.5)],
    38. 

  38.                 t: [rnd(width * 0.5), 0],
    39. 

  39.                 l: [0, rnd(height * 0.5)],
    40. 

  40.                 r: [width, rnd(height * 0.5)],
    41. 

  41.                 b: [rnd(width * 0.5), height],
    42. 

  42.                 tl: [0, 0],
    43. 

  43.                 bl: [0, height],
    44. 

  44.                 br: [width, height],
    45. 

  45.                 tr: [width, 0]
    46. 

  46.             };
    47. 

  47. 

  48.         xy = hash[anchor];
    49. 

  49.         return [xy[0] + extraX, xy[1] + extraY];
    50. 

  50.     },
    51. 

  51. 

  52.     <div id="method-Ext.Element-getAlignToXY"></div>/**
    53. 

  53.      * Gets the x,y coordinates to align this element with another element. See {@link #alignTo} for more info on the
    54. 

  54.      * supported position values.
    55. 

  55.      * @param {Mixed} element The element to align to.
    56. 

  56.      * @param {String} position (optional, defaults to "tl-bl?") The position to align to.
    57. 

  57.      * @param {Array} offsets (optional) Offset the positioning by [x, y]
    58. 

  58.      * @return {Array} [x, y]
    59. 

  59.      */
    60. 

  60.     getAlignToXY: function(el, position, offsets) {
    61. 

  61.         el = Ext.get(el);
    62. 

  62. 

  63.         //<debug>
    64. 

  64.         if (!el || !el.dom) {
    65. 

  65.             throw new Error("Element.alignToXY with an element that doesn't exist");
    66. 

  66.         }
    67. 

  67.         //</debug>
    68. 

  68.         offsets = offsets || [0, 0];
    69. 

  69. 

  70.         if (!position || position == '?') {
    71. 

  71.             position = 'tl-bl?';
    72. 

  72.         }
    73. 

  73.         else if (! (/-/).test(position) && position !== "") {
    74. 

  74.             position = 'tl-' + position;
    75. 

  75.         }
    76. 

  76.         position = position.toLowerCase();
    77. 

  77. 

  78.         var me = this,
    79. 

  79.             matches = position.match(/^([a-z]+)-([a-z]+)(\?)?$/),
    80. 

  80.             dw = window.innerWidth,
    81. 

  81.             dh = window.innerHeight,
    82. 

  82.             p1 = "",
    83. 

  83.             p2 = "",
    84. 

  84.             a1,
    85. 

  85.             a2,
    86. 

  86.             x,
    87. 

  87.             y,
    88. 

  88.             swapX,
    89. 

  89.             swapY,
    90. 

  90.             p1x,
    91. 

  91.             p1y,
    92. 

  92.             p2x,
    93. 

  93.             p2y,
    94. 

  94.             width,
    95. 

  95.             height,
    96. 

  96.             region,
    97. 

  97.             constrain;
    98. 

  98. 

  99.         if (!matches) {
    100. 

  100.             throw "Element.alignTo with an invalid alignment " + position;
    101. 

  101.         }
    102. 

  102. 

  103.         p1 = matches[1];
    104. 

  104.         p2 = matches[2];
    105. 

  105.         constrain = !!matches[3];
    106. 

  106. 

  107.         //Subtract the aligned el's internal xy from the target's offset xy
    108. 

  108.         //plus custom offset to get the aligned el's new offset xy
    109. 

  109.         a1 = me.getAnchorXY(p1, true);
    110. 

  110.         a2 = el.getAnchorXY(p2, false);
    111. 

  111. 

  112.         x = a2[0] - a1[0] + offsets[0];
    113. 

  113.         y = a2[1] - a1[1] + offsets[1];
    114. 

  114. 

  115.         if (constrain) {
    116. 

  116.             width = me.getWidth();
    117. 

  117.             height = me.getHeight();
    118. 

  118. 

  119.             region = el.getPageBox();
    120. 

  120. 

  121.             //If we are at a viewport boundary and the aligned el is anchored on a target border that is
    122. 

  122.             //perpendicular to the vp border, allow the aligned el to slide on that border,
    123. 

  123.             //otherwise swap the aligned el to the opposite border of the target.
    124. 

  124.             p1y = p1.charAt(0);
    125. 

  125.             p1x = p1.charAt(p1.length - 1);
    126. 

  126.             p2y = p2.charAt(0);
    127. 

  127.             p2x = p2.charAt(p2.length - 1);
    128. 

  128. 

  129.             swapY = ((p1y == "t" && p2y == "b") || (p1y == "b" && p2y == "t"));
    130. 

  130.             swapX = ((p1x == "r" && p2x == "l") || (p1x == "l" && p2x == "r"));
    131. 

  131. 

  132.             if (x + width > dw) {
    133. 

  133.                 x = swapX ? region.left - width: dw - width;
    134. 

  134.             }
    135. 

  135.             if (x < 0) {
    136. 

  136.                 x = swapX ? region.right: 0;
    137. 

  137.             }
    138. 

  138.             if (y + height > dh) {
    139. 

  139.                 y = swapY ? region.top - height: dh - height;
    140. 

  140.             }
    141. 

  141.             if (y < 0) {
    142. 

  142.                 y = swapY ? region.bottom: 0;
    143. 

  143.             }
    144. 

  144.         }
    145. 

  145. 

  146.         return [x, y];
    147. 

  147.     }
    148. 

  148. 

  149.     /*
    150. 

  150.      * Anchors an element to another element and realigns it when the window is resized.
    151. 

  151.      * @param {Mixed} element The element to align to.
    152. 

  152.      * @param {String} position The position to align to.
    153. 

  153.      * @param {Array} offsets (optional) Offset the positioning by [x, y]
    154. 

  154.      * @param {Boolean/Object} animate (optional) True for the default animation or a standard Element animation config object
    155. 

  155.      * @param {Boolean/Number} monitorScroll (optional) True to monitor body scroll and reposition. If this parameter
    156. 

  156.      * is a number, it is used as the buffer delay (defaults to 50ms).
    157. 

  157.      * @param {Function} callback The function to call after the animation finishes
    158. 

  158.      * @return {Ext.Element} this
    159. 

  159.      */
    160. 

  160.     // anchorTo : function(el, alignment, offsets, animate, monitorScroll, callback){
    161. 

  161.     //      var me = this,
    162. 

  162.     //         dom = me.dom,
    163. 

  163.     //         scroll = !Ext.isEmpty(monitorScroll),
    164. 

  164.     //         action = function(){
    165. 

  165.     //             Ext.fly(dom).alignTo(el, alignment, offsets, animate);
    166. 

  166.     //             Ext.callback(callback, Ext.fly(dom));
    167. 

  167.     //         },
    168. 

  168.     //         anchor = this.getAnchor();
    169. 

  169.     //
    170. 

  170.     //     // previous listener anchor, remove it
    171. 

  171.     //     this.removeAnchor();
    172. 

  172.     //     Ext.apply(anchor, {
    173. 

  173.     //         fn: action,
    174. 

  174.     //         scroll: scroll
    175. 

  175.     //     });
    176. 

  176.     //
    177. 

  177.     //     Ext.EventManager.onWindowResize(action, null);
    178. 

  178.     //
    179. 

  179.     //     if(scroll){
    180. 

  180.     //         Ext.EventManager.on(window, 'scroll', action, null,
    181. 

  181.     //             {buffer: !isNaN(monitorScroll) ? monitorScroll : 50});
    182. 

  182.     //     }
    183. 

  183.     //     action.call(me); // align immediately
    184. 

  184.     //     return me;
    185. 

  185.     // },
    186. 

  186.     /*
    187. 

  187.      * Remove any anchor to this element. See {@link #anchorTo}.
    188. 

  188.      * @return {Ext.Element} this
    189. 

  189.      */
    190. 

  190.     // removeAnchor : function(){
    191. 

  191.     //     var me = this,
    192. 

  192.     //         anchor = this.getAnchor();
    193. 

  193.     //
    194. 

  194.     //     if(anchor && anchor.fn){
    195. 

  195.     //         Ext.EventManager.removeResizeListener(anchor.fn);
    196. 

  196.     //         if(anchor.scroll){
    197. 

  197.     //             Ext.EventManager.un(window, 'scroll', anchor.fn);
    198. 

  198.     //         }
    199. 

  199.     //         delete anchor.fn;
    200. 

  200.     //     }
    201. 

  201.     //     return me;
    202. 

  202.     // },
    203. 

  203.     //
    204. 

  204.     // // private
    205. 

  205.     // getAnchor : function(){
    206. 

  206.     //     var data = Ext.Element.data,
    207. 

  207.     //         dom = this.dom;
    208. 

  208.     //         if (!dom) {
    209. 

  209.     //             return;
    210. 

  210.     //         }
    211. 

  211.     //         var anchor = data(dom, '_anchor');
    212. 

  212.     //
    213. 

  213.     //     if(!anchor){
    214. 

  214.     //         anchor = data(dom, '_anchor', {});
    215. 

  215.     //     }
    216. 

  216.     //     return anchor;
    217. 

  217.     // },
    218. 

  218.     /*
    219. 

  219.      * Aligns this element with another element relative to the specified anchor points. If the other element is the
    220. 

  220.      * document it aligns it to the viewport.
    221. 

  221.      * The position parameter is optional, and can be specified in any one of the following formats:
    222. 

  222.      * <ul>
    223. 

  223.      *   <li><b>Blank</b>: Defaults to aligning the element's top-left corner to the target's bottom-left corner ("tl-bl").</li>
    224. 

  224.      *   <li><b>One anchor (deprecated)</b>: The passed anchor position is used as the target element's anchor point.
    225. 

  225.      *       The element being aligned will position its top-left corner (tl) to that point.  <i>This method has been
    226. 

  226.      *       deprecated in favor of the newer two anchor syntax below</i>.</li>
    227. 

  227.      *   <li><b>Two anchors</b>: If two values from the table below are passed separated by a dash, the first value is used as the
    228. 

  228.      *       element's anchor point, and the second value is used as the target's anchor point.</li>
    229. 

  229.      * </ul>
    230. 

  230.      * In addition to the anchor points, the position parameter also supports the "?" character.  If "?" is passed at the end of
    231. 

  231.      * the position string, the element will attempt to align as specified, but the position will be adjusted to constrain to
    232. 

  232.      * the viewport if necessary.  Note that the element being aligned might be swapped to align to a different position than
    233. 

  233.      * that specified in order to enforce the viewport constraints.
    234. 

  234.      * Following are all of the supported anchor positions:
    235. 

  235. <pre>
    236. 

  236. Value  Description
    237. 

  237. -----  -----------------------------
    238. 

  238. tl     The top left corner (default)
    239. 

  239. t      The center of the top edge
    240. 

  240. tr     The top right corner
    241. 

  241. l      The center of the left edge
    242. 

  242. c      In the center of the element
    243. 

  243. r      The center of the right edge
    244. 

  244. bl     The bottom left corner
    245. 

  245. b      The center of the bottom edge
    246. 

  246. br     The bottom right corner
    247. 

  247. </pre>
    248. 

  248. Example Usage:
    249. 

  249. <pre><code>
    250. 

  250. // align el to other-el using the default positioning ("tl-bl", non-constrained)
    251. 

  251. el.alignTo("other-el");
    252. 

    253. 

  253. // align the top left corner of el with the top right corner of other-el (constrained to viewport)
    254. 

  254. el.alignTo("other-el", "tr?");
    255. 

    256. 

  256. // align the bottom right corner of el with the center left edge of other-el
    257. 

  257. el.alignTo("other-el", "br-l?");
    258. 

    259. 

  259. // align the center of el with the bottom left corner of other-el and
    260. 

  260. // adjust the x position by -6 pixels (and the y position by 0)
    261. 

  261. el.alignTo("other-el", "c-bl", [-6, 0]);
    262. 

  262. </code></pre>
    263. 

  263.      * @param {Mixed} element The element to align to.
    264. 

  264.      * @param {String} position (optional, defaults to "tl-bl?") The position to align to.
    265. 

  265.      * @param {Array} offsets (optional) Offset the positioning by [x, y]
    266. 

  266.      * @param {Boolean/Object} animate (optional) true for the default animation or a standard Element animation config object
    267. 

  267.      * @return {Ext.Element} this
    268. 

  268.      */
    269. 

  269.     // alignTo : function(element, position, offsets, animate){
    270. 

  270.     //      var me = this;
    271. 

  271.     //     return me.setXY(me.getAlignToXY(element, position, offsets),
    272. 

  272.     //                      me.preanim && !!animate ? me.preanim(arguments, 3) : false);
    273. 

  273.     // },
    274. 

  274.     //
    275. 

  275.     // // private ==>  used outside of core
    276. 

  276.     // adjustForConstraints : function(xy, parent, offsets){
    277. 

  277.     //     return this.getConstrainToXY(parent || document, false, offsets, xy) ||  xy;
    278. 

  278.     // },
    279. 

  279.     //
    280. 

  280.     // // private ==>  used outside of core
    281. 

  281.     // getConstrainToXY : function(el, local, offsets, proposedXY){
    282. 

  282.     //      var os = {top:0, left:0, bottom:0, right: 0};
    283. 

  283.     //
    284. 

  284.     //     return function(el, local, offsets, proposedXY){
    285. 

  285.     //         el = Ext.get(el);
    286. 

  286.     //         offsets = offsets ? Ext.applyIf(offsets, os) : os;
    287. 

  287.     //
    288. 

  288.     //         var vw, vh, vx = 0, vy = 0;
    289. 

  289.     //         if(el.dom == document.body || el.dom == document){
    290. 

  290.     //             vw =Ext.lib.Dom.getViewWidth();
    291. 

  291.     //             vh = Ext.lib.Dom.getViewHeight();
    292. 

  292.     //         }else{
    293. 

  293.     //             vw = el.dom.clientWidth;
    294. 

  294.     //             vh = el.dom.clientHeight;
    295. 

  295.     //             if(!local){
    296. 

  296.     //                 var vxy = el.getXY();
    297. 

  297.     //                 vx = vxy[0];
    298. 

  298.     //                 vy = vxy[1];
    299. 

  299.     //             }
    300. 

  300.     //         }
    301. 

  301.     //
    302. 

  302.     //         var s = el.getScroll();
    303. 

  303.     //
    304. 

  304.     //         vx += offsets.left + s.left;
    305. 

  305.     //         vy += offsets.top + s.top;
    306. 

  306.     //
    307. 

  307.     //         vw -= offsets.right;
    308. 

  308.     //         vh -= offsets.bottom;
    309. 

  309.     //
    310. 

  310.     //         var vr = vx + vw,
    311. 

  311.     //             vb = vy + vh,
    312. 

  312.     //             xy = proposedXY || (!local ? this.getXY() : [this.getLeft(true), this.getTop(true)]),
    313. 

  313.     //             x = xy[0], y = xy[1],
    314. 

  314.     //             offset = this.getConstrainOffset(),
    315. 

  315.     //             w = this.dom.offsetWidth + offset,
    316. 

  316.     //             h = this.dom.offsetHeight + offset;
    317. 

  317.     //
    318. 

  318.     //         // only move it if it needs it
    319. 

  319.     //         var moved = false;
    320. 

  320.     //
    321. 

  321.     //         // first validate right/bottom
    322. 

  322.     //         if((x + w) > vr){
    323. 

  323.     //             x = vr - w;
    324. 

  324.     //             moved = true;
    325. 

  325.     //         }
    326. 

  326.     //         if((y + h) > vb){
    327. 

  327.     //             y = vb - h;
    328. 

  328.     //             moved = true;
    329. 

  329.     //         }
    330. 

  330.     //         // then make sure top/left isn't negative
    331. 

  331.     //         if(x < vx){
    332. 

  332.     //             x = vx;
    333. 

  333.     //             moved = true;
    334. 

  334.     //         }
    335. 

  335.     //         if(y < vy){
    336. 

  336.     //             y = vy;
    337. 

  337.     //             moved = true;
    338. 

  338.     //         }
    339. 

  339.     //         return moved ? [x, y] : false;
    340. 

  340.     //     };
    341. 

  341.     // }(),
    342. 

  342.     //
    343. 

  343.     // // private, used internally
    344. 

  344.     // getConstrainOffset : function(){
    345. 

  345.     //     return 0;
    346. 

  346.     // },
    347. 

  347.     //
    348. 

  348.     // <div id="method-Ext.Element-getCenterXY"></div>/**
    349. 

  349.     // * Calculates the x, y to center this element on the screen
    350. 

  350.     // * @return {Array} The x, y values [x, y]
    351. 

  351.     // */
    352. 

  352.     // getCenterXY : function(){
    353. 

  353.     //     return this.getAlignToXY(document, 'c-c');
    354. 

  354.     // },
    355. 

  355.     //
    356. 

  356.     // <div id="method-Ext.Element-center"></div>/**
    357. 

  357.     // * Centers the Element in either the viewport, or another Element.
    358. 

  358.     // * @param {Mixed} centerIn (optional) The element in which to center the element.
    359. 

  359.     // */
    360. 

  360.     // center : function(centerIn) {
    361. 

  361.     //     return this.alignTo(centerIn || document, 'c-c');
    362. 

  362.     // }
    363. 

  363. });
    364. 

  364. </pre>    
    365. 

  365. </body>
    366. 

  366. </html>
    367.