sproutcore 1.4.5 → 1.5.0.pre.3

data/lib/frameworks/sproutcore/frameworks/amber/system/utils.js

@@ -0,0 +1,174 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2010 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+// These are helpful utility functions for calculating range and rect values
+sc_require('system/browser');
+
+SC.mixin( /** @scope SC */ {
+
+  /**
+    Takes a URL of any type and normalizes it into a fully qualified URL with
+    hostname.  For example:
+
+    {{{
+      "some/path" => "http://localhost:4020/some/path"
+      "/some/path" => "http://localhost:4020/some/path"
+      "http://localhost:4020/some/path" => "http://localhost:4020/some/path"
+    }}}
+
+    @param url {String} the URL
+    @returns {String} the normalized URL
+  */
+  normalizeURL: function(url) {
+    if (url.slice(0,1) == '/') {
+      url = window.location.protocol + '//' + window.location.host + url ;
+    } else if ((url.slice(0,5) == 'http:') || (url.slice(0,6) == 'https:')) {
+      // no change
+    } else {
+      url = window.location.href + '/' + url ;
+    }
+    return url ;
+  },
+
+  /** Return true if the number is between 0 and 1 */
+  isPercentage: function(val){
+    return (val<1 && val>0);
+  },
+
+  /** Return the left edge of the frame */
+  minX: function(frame) {
+    return frame.x || 0;
+  },
+
+  /** Return the right edge of the frame. */
+  maxX: function(frame) {
+    return (frame.x || 0) + (frame.width || 0);
+  },
+
+  /** Return the midpoint of the frame. */
+  midX: function(frame) {
+    return (frame.x || 0) + ((frame.width || 0) / 2) ;
+  },
+
+  /** Return the top edge of the frame */
+  minY: function(frame) {
+    return frame.y || 0 ;
+  },
+
+  /** Return the bottom edge of the frame */
+  maxY: function(frame) {
+    return (frame.y || 0) + (frame.height || 0) ;
+  },
+
+  /** Return the midpoint of the frame */
+  midY: function(frame) {
+    return (frame.y || 0) + ((frame.height || 0) / 2) ;
+  },
+
+  /** Returns the point that will center the frame X within the passed frame. */
+  centerX: function(innerFrame, outerFrame) {
+    return (outerFrame.width - innerFrame.width) / 2 ;
+  },
+
+  /** Return the point that will center the frame Y within the passed frame. */
+  centerY: function(innerFrame, outerFrame) {
+    return (outerFrame.height - innerFrame.height) /2  ;
+  },
+
+  /** Finds the absolute viewportOffset for a given element.
+    This method is more accurate than the version provided by prototype.
+
+    If you pass NULL to this method, it will return a { x:0, y:0 }
+    @param el The DOM element
+    @returns {Point} A hash with x,y offsets.
+  */
+  viewportOffset: function(el) {
+    // Some browsers natively implement getBoundingClientRect, so if it's
+    // available we'll use it for speed.
+    if (el.getBoundingClientRect) {
+      var boundingRect = el.getBoundingClientRect(),
+          isIOS41 = false;
+      // we need to detect the mobileSafari build number in the userAgent.
+      // The webkit versions are the same but the results returned by getBoundingClientRect
+      // are very different one includes the scrolling from the top of the document , the other
+      // doesnt
+      if (SC.browser.mobileSafari){
+        var userAgent = navigator.userAgent,
+            index = userAgent.indexOf('Mobile/'),
+            mobileBuildNumber = userAgent.substring(index+7, index+9);
+        if (mobileBuildNumber > "8A") isIOS41 = true;
+
+      }
+
+      if (SC.browser.mobileSafari && (parseInt(SC.browser.mobileSafari, 0)>532 || isIOS41)) {
+        return { x:boundingRect.left+(window.pageXOffset || 0), y:boundingRect.top+(window.pageYOffset || 0) };
+      }
+      else{
+        return { x:boundingRect.left, y:boundingRect.top };
+      }
+    }
+
+    var valueL = 0, valueT = 0, cqElement, overflow, left, top, offsetParent,
+        element = el, isFirefox3 = SC.browser.mozilla >= 3 ;
+    // add up all the offsets for the element.
+
+    while (element) {
+      cqElement = SC.$(element);
+      valueT += (element.offsetTop  || 0);
+      if (!isFirefox3 || (element !== el)) {
+        valueT += (element.clientTop  || 0);
+      }
+
+      valueL += (element.offsetLeft || 0);
+      if (!isFirefox3 || (element !== el)) {
+        valueL += (element.clientLeft || 0);
+      }
+
+      // bizarely for FireFox if your offsetParent has a border, then it can
+      // impact the offset.
+      if (SC.browser.mozilla) {
+        overflow = cqElement.attr('overflow') ;
+        if (overflow !== 'visible') {
+          left = parseInt(cqElement.attr('borderLeftWidth'),0) || 0 ;
+          top = parseInt(cqElement.attr('borderTopWidth'),0) || 0 ;
+          if (el !== element) {
+            left *= 2; top *= 2 ;
+          }
+          valueL += left; valueT += top ;
+        }
+
+        // In FireFox 3 -- the offsetTop/offsetLeft subtracts the clientTop/
+        // clientLeft of the offset parent.
+        offsetParent = element.offsetParent ;
+        if (SC.browser.mozilla.match(/1[.]9/) && offsetParent) {
+          valueT -= offsetParent.clientTop ;
+          valueL -= offsetParent.clientLeft;
+        }
+      }
+
+      // Safari fix
+      if (element.offsetParent == document.body &&
+        cqElement.attr('position') === 'absolute') break;
+
+      element = element.offsetParent ;
+
+    }
+
+    element = el;
+    while (element) {
+      if (!SC.browser.isOpera || element.tagName === 'BODY') {
+        valueT -= element.scrollTop  || 0;
+        valueL -= element.scrollLeft || 0;
+      }
+
+      element = element.parentNode ;
+    }
+
+    return { x: valueL, y: valueT } ;
+  }
+
+}) ;

data/lib/frameworks/sproutcore/frameworks/amber/system/utils/rect.js

@@ -0,0 +1,98 @@
+SC.mixin( /** @scope SC */ {
+  /** A Point at {0,0} */
+  ZERO_POINT: { x: 0, y: 0 },
+
+  /** Check if the given point is inside the rect. */
+  pointInRect: function(point, f) {
+    return  (point.x >= SC.minX(f)) &&
+            (point.y >= SC.minY(f)) &&
+            (point.x <= SC.maxX(f)) &&
+            (point.y <= SC.maxY(f)) ;
+  },
+
+  /** Return true if the two frames match.  You can also pass only points or sizes.
+
+    @param r1 {Rect} the first rect
+    @param r2 {Rect} the second rect
+    @param delta {Float} an optional delta that allows for rects that do not match exactly. Defaults to 0.1
+    @returns {Boolean} true if rects match
+   */
+  rectsEqual: function(r1, r2, delta) {
+    if (!r1 || !r2) return (r1 == r2) ;
+    if (!delta && delta !== 0) delta = 0.1;
+    if ((r1.y != r2.y) && (Math.abs(r1.y - r2.y) > delta)) return NO ;
+    if ((r1.x != r2.x) && (Math.abs(r1.x - r2.x) > delta)) return NO ;
+    if ((r1.width != r2.width) && (Math.abs(r1.width - r2.width) > delta)) return NO ;
+    if ((r1.height != r2.height) && (Math.abs(r1.height - r2.height) > delta)) return NO ;
+    return YES ;
+  },
+
+  /** Returns the insersection between two rectangles.
+
+    @param r1 {Rect} The first rect
+    @param r2 {Rect} the second rect
+    @returns {Rect} the intersection rect.  width || height will be 0 if they do not interset.
+  */
+  intersectRects: function(r1, r2) {
+    // find all four edges
+    var ret = {
+      x: Math.max(SC.minX(r1), SC.minX(r2)),
+      y: Math.max(SC.minY(r1), SC.minY(r2)),
+      width: Math.min(SC.maxX(r1), SC.maxX(r2)),
+      height: Math.min(SC.maxY(r1), SC.maxY(r2))
+    } ;
+
+    // convert edges to w/h
+    ret.width = Math.max(0, ret.width - ret.x) ;
+    ret.height = Math.max(0, ret.height - ret.y) ;
+    return ret ;
+  },
+
+  /** Returns the union between two rectangles
+
+    @param r1 {Rect} The first rect
+    @param r2 {Rect} The second rect
+    @returns {Rect} The union rect.
+  */
+  unionRects: function(r1, r2) {
+    // find all four edges
+    var ret = {
+      x: Math.min(SC.minX(r1), SC.minX(r2)),
+      y: Math.min(SC.minY(r1), SC.minY(r2)),
+      width: Math.max(SC.maxX(r1), SC.maxX(r2)),
+      height: Math.max(SC.maxY(r1), SC.maxY(r2))
+    } ;
+
+    // convert edges to w/h
+    ret.width = Math.max(0, ret.width - ret.x) ;
+    ret.height = Math.max(0, ret.height - ret.y) ;
+    return ret ;
+  },
+
+  /** Duplicates the passed rect.
+
+    This is faster than Object.clone().
+
+    @param r {Rect} The rect to clone.
+    @returns {Rect} The cloned rect
+  */
+  cloneRect: function(r) {
+    return { x: r.x, y: r.y, width: r.width, height: r.height } ;
+  },
+
+  /** Returns a string representation of the rect as {x, y, width, height}.
+
+    @param r {Rect} The rect to stringify.
+    @returns {String} A string representation of the rect.
+  */
+  stringFromRect: function(r) {
+    if (!r) {
+      return "(null)";
+    }
+    else {
+      return '{x:'+r.x+', y:'+r.y+', width:'+r.width+', height:'+r.height+'}';
+    }
+  }
+
+
+});

data/lib/frameworks/sproutcore/frameworks/{foundation → amber}/tests/controllers/array/array_case.js

@@ -10,14 +10,14 @@
 var content, controller, extra;
 
 var TestObject = SC.Object.extend({
-  title: "test",  
+  title: "test",
   toString: function() { return "TestObject(%@)".fmt(this.get("title")); }
 });
 
 
 // ..........................................................
 // EMPTY
-// 
+//
 
 module("SC.ArrayController - array_case - EMPTY", {
   setup: function() {
@@ -25,7 +25,7 @@ module("SC.ArrayController - array_case - EMPTY", {
     controller = SC.ArrayController.create({ content: content });
     extra = TestObject.create({ title: "FOO" });
   },
-  
+
   teardown: function() {
     controller.destroy();
   }
@@ -42,9 +42,9 @@ test("state properties", function() {
 test("addObject", function() {
   var callCount = 0;
   controller.addObserver('[]', function() { callCount++; });
-  
+
   SC.run(function() { controller.addObject(extra); });
-  
+
   same(content, [extra], 'addObject(extra) should work');
   equals(callCount, 1, 'should notify observer that content has changed');
   equals(content.get('length'), 1, 'should update length of controller');
@@ -53,9 +53,9 @@ test("addObject", function() {
 test("removeObject", function() {
   var callCount = 0;
   controller.addObserver('[]', function() { callCount++; });
-  
+
   SC.run(function() { controller.removeObject(extra); });
-  
+
   same(content, [], 'removeObject(extra) should have no effect');
   equals(callCount, 0, 'should not notify observer since content did not change');
 });
@@ -68,9 +68,9 @@ test("basic array READ operations", function() {
 test("basic array WRITE operations", function() {
   var callCount = 0;
   controller.addObserver('[]', function() { callCount++; });
-  
+
   controller.replace(0,1,[extra]);
-  
+
   same(content, [extra], 'should modify content');
   equals(callCount, 1, 'should notify observer that content has changed');
   equals(content.get('length'), 1, 'should update length of controller');
@@ -83,18 +83,18 @@ test("arrangedObjects", function() {
 
 // ..........................................................
 // NON-EMPTY ARRAY
-// 
+//
 
 module("SC.ArrayController - array_case - NON-EMPTY", {
   setup: function() {
     content = "1 2 3 4 5".w().map(function(x) {
       return TestObject.create({ title: x });
     });
-    
+
     controller = SC.ArrayController.create({ content: content });
     extra = TestObject.create({ title: "FOO" });
   },
-  
+
   teardown: function() {
     controller.destroy();
   }
@@ -111,12 +111,12 @@ test("state properties", function() {
 test("addObject", function() {
   var expected = content.slice();
   expected.push(extra);
-  
+
   var callCount = 0;
   controller.addObserver('[]', function() { callCount++; });
-  
+
   SC.run(function() { controller.addObject(extra); });
-  
+
   same(content, expected, 'addObject(extra) should work');
   equals(callCount, 1, 'should notify observer that content has changed');
   equals(content.get('length'), expected.length, 'should update length of controller');
@@ -125,12 +125,12 @@ test("addObject", function() {
 test("removeObject", function() {
   var expected = content.slice(), obj = expected[3];
   expected.removeObject(obj);
-  
+
   var callCount = 0;
   controller.addObserver('[]', function() { callCount++; });
-  
+
   SC.run(function() { controller.removeObject(obj); });
-  
+
   same(content, expected, 'removeObject(extra) should remove object');
   equals(callCount, 1, 'should notify observer that content has changed');
   equals(content.get('length'), expected.length, 'should update length of controller');
@@ -138,7 +138,7 @@ test("removeObject", function() {
 
 test("basic array READ operations", function() {
   equals(controller.get("length"), content.length, 'length should be empty');
-  
+
   var loc = content.length+1; // verify 1 past end as well
   while(--loc>=0) {
     equals(controller.objectAt(loc), content[loc], "objectAt(%@) should return same value at content[%@]".fmt(loc, loc));
@@ -148,12 +148,12 @@ test("basic array READ operations", function() {
 test("basic array WRITE operations", function() {
   var expected = content.slice();
   expected.replace(3,1,[extra]);
-  
+
   var callCount = 0;
   controller.addObserver('[]', function() { callCount++; });
-  
+
   controller.replace(3,1,[extra]);
-  
+
   same(content, expected, 'should modify content');
   equals(callCount, 1, 'should notify observer that content has changed');
   equals(content.get('length'), expected.length, 'should update length of controller');
@@ -164,14 +164,14 @@ test("arrangedObjects", function() {
 });
 
 test("array orderBy using function", function(){
-  var testFunc = function(a,b){ 
+  var testFunc = function(a,b){
     if(a.get('title') > b.get('title')) return -1;
-    else if (a.get('title') == b.get('title')) return 0; 
-    else return 1; 
+    else if (a.get('title') == b.get('title')) return 0;
+    else return 1;
   };
   var expected = content.slice();
   expected.sort(testFunc);
-  
+
   var testController = SC.ArrayController.create({
     content: content,
     orderBy: testFunc
@@ -181,23 +181,23 @@ test("array orderBy using function", function(){
 
 // ..........................................................
 // ADD SPECIAL CASES HERE
-// 
+//
 
 test("verify rangeObserver fires when content is deleted", function() {
-  
+
   content = "1 2 3 4 5".w().map(function(x) {
     return TestObject.create({ title: x });
   });
-  
+
   controller = SC.ArrayController.create({ content: content });
 
   var cnt = 0,
       observer = SC.Object.create({ method: function() { cnt++; } });
   controller.addRangeObserver(SC.IndexSet.create(0,2), observer, observer.method);
-      
+
   SC.RunLoop.begin();
   content.length = 0 ;
-  content.enumerableContentDidChange(); 
+  content.enumerableContentDidChange();
   SC.RunLoop.end();
 
   equals(cnt, 1, 'range observer should have fired once');
@@ -206,13 +206,13 @@ test("verify rangeObserver fires when content is deleted", function() {
 
 // ..........................................................
 // VERIFY SC.ARRAY COMPLIANCE
-// 
-
-// SC.ArraySuite.generate("SC.ArrayController", {
-//   newObject: function(amt) {
-//     if (amt === undefined || typeof amt === SC.T_NUMBER) {
-//       amt = this.expected(amt);
-//     }
-//     return SC.ArrayController.create({ content: amt });
-//   }
-// });
+//
+
+SC.ArraySuite.generate("SC.ArrayController", {
+  newObject: function(amt) {
+    if (amt === undefined || typeof amt === SC.T_NUMBER) {
+      amt = this.expected(amt);
+    }
+    return SC.ArrayController.create({ content: amt });
+  }
+});