sproutit-sproutcore 1.0.0.20090407205609 → 1.0.0.20090408130025

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/parentViewDidChange.js

@@ -0,0 +1,67 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: �2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same */
+
+var view ;
+module("SC.View#parentViewDidChange", {
+	setup: function() {
+		view = SC.View.create();		
+	}
+});
+
+test("invokes updateLayerLocationIfNeeded at end of runloop if has layer", function() {
+	
+	view.createLayer();
+	ok(view.get('layer'), 'precond - has layer');
+	
+	var runCount = 0;
+	view.updateLayerLocationIfNeeded = function() { runCount++; };
+	
+	SC.RunLoop.begin();
+	view.parentViewDidChange();
+	SC.RunLoop.end();
+
+	equals(runCount, 1, 'did invoke');
+	
+});
+
+test("invokes updateLayerLocationIfNeeded only once no matter how many times it is run", function() {
+	
+	view.createLayer();
+	ok(view.get('layer'), 'precond - has layer');
+	
+	var runCount = 0;
+	view.updateLayerLocationIfNeeded = function() { runCount++; };
+	
+	SC.RunLoop.begin();
+	view.parentViewDidChange();
+	view.parentViewDidChange();
+	view.parentViewDidChange();
+	SC.RunLoop.end();
+
+	equals(runCount, 1, 'did invoke once');
+	
+});
+
+test("calls recomputeIsVisibleInWindow each time it is called", function() {
+
+	var runCount = 0;
+	view.recomputeIsVisibleInWindow = function() { runCount++; };
+	
+	SC.RunLoop.begin();
+	view.parentViewDidChange();
+	view.parentViewDidChange();
+	view.parentViewDidChange();
+	SC.RunLoop.end();
+
+	equals(runCount, 3, 'did invoke each time');	
+});
+
+test("returns receiver", function() {
+	equals(view.parentViewDidChange(), view, 'receiver');
+});
+

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/prepareContext.js

@@ -0,0 +1,166 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: �2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same */
+
+module("SC.View#prepareContext");
+
+test("populates context with layerId & classNames from view if firstTime", function() {
+  var view = SC.View.create({
+    layerId: "foo", 
+    classNames: ["bar"] 
+  });
+  var context = view.renderContext();
+  
+  // test with firstTime
+  view.prepareContext(context, YES);
+  equals(context.id(), 'foo', 'did set id');
+  ok(context.hasClass('bar'), 'did set class names');
+  
+  // test w/o firstTime
+  context = view.renderContext();
+  view.prepareContext(context, NO);
+  ok(context.id() !== 'foo', 'did not set id');
+  ok(!context.hasClass('bar'), 'did not set class name');
+});
+
+test("invokes renderLayout if first time", function() {
+  var runCount = 0;
+  var context, isFirstTime ;
+  var view = SC.View.create({
+    renderLayout: function(aContext, firstTime) { 
+    	equals(aContext, context, 'passed context');
+    	equals(firstTime, isFirstTime, 'passed firstTime');
+    	runCount++; 
+    }
+  });
+  
+	// test w/ firstTime
+  context = view.renderContext();
+  isFirstTime = YES ;
+	view.prepareContext(context, YES);
+	equals(runCount, 1, 'should call renderLayout');
+	
+	// test w/o firstTime
+	runCount = 0 ;
+  context = view.renderContext();
+  isFirstTime = NO ;
+	view.prepareContext(context, NO);
+	equals(runCount, 0, 'should not call renderLayout');
+
+});
+
+
+test("adds text-selectable class if view has isTextSelectable", function() {
+
+  var view = SC.View.create() ;
+  var context ;
+  
+  context = view.renderContext();
+  view.set('isTextSelectable', YES);
+  view.prepareContext(context, YES);
+  ok(context.hasClass('allow-select'), 'should have text-selectable class');
+  
+  context = view.renderContext();
+  view.set('isTextSelectable', NO);
+  view.prepareContext(context, YES);
+  ok(!context.hasClass('allow-select'), 'should NOT have text-selectable class');
+  
+});
+
+test("adds disabled class if view isEnabled = NO", function() {
+
+  var view = SC.View.create() ;
+  var context ;
+  
+  context = view.renderContext();
+  view.set('isEnabled', YES);
+  view.prepareContext(context, YES);
+  ok(!context.hasClass('disabled'), 'should NOT have disabled class');
+  
+  context = view.renderContext();
+  view.set('isEnabled', NO);
+  view.prepareContext(context, YES);
+  ok(context.hasClass('disabled'), 'should have disabled class');
+  
+});
+
+test("adds hidden class if view isVisible = NO", function() {
+
+  var view = SC.View.create() ;
+  var context ;
+  
+  context = view.renderContext();
+  view.set('isVisible', YES);
+  view.prepareContext(context, YES);
+  ok(!context.hasClass('hidden'), 'should NOT have hidden class');
+  
+  context = view.renderContext();
+  view.set('isVisible', NO);
+  view.prepareContext(context, YES);
+  ok(context.hasClass('hidden'), 'should have hidden class');  
+});
+
+test("invokes render() passing context & firstTime", function() {
+
+	var runCount = 0;
+  var context, isFirstTime ;
+  var view = SC.View.create({
+  	render: function(theContext, firstTime) {
+  		equals(context, theContext, 'context passed');
+  		equals(firstTime, isFirstTime, 'firstTime passed');
+  		runCount++;
+  	}
+  }) ;
+  
+  context = view.renderContext();
+  isFirstTime = YES;
+	view.prepareContext(context, YES);  
+	equals(runCount, 1, 'did invoke render()');
+
+  runCount = 0 ;
+  context = view.renderContext();
+  isFirstTime = NO;
+	view.prepareContext(context, NO);  
+	equals(runCount, 1, 'did invoke render()');
+});
+
+test("invokes renderMixin() from mixins, passing context & firstTime", function() {
+
+	var runCount = 0;
+  var context, isFirstTime ;
+	
+	// define a few mixins to make sure this works w/ multiple mixins  	
+	var mixinA = {
+  	renderMixin: function(theContext, firstTime) {
+  		equals(context, theContext, 'context passed');
+  		equals(firstTime, isFirstTime, 'firstTime passed');
+  		runCount++;
+  	}
+	};
+
+	var mixinB = {
+  	renderMixin: function(theContext, firstTime) {
+  		equals(context, theContext, 'context passed');
+  		equals(firstTime, isFirstTime, 'firstTime passed');
+  		runCount++;
+  	}
+	};
+
+  var view = SC.View.create(mixinA, mixinB) ;
+  
+  context = view.renderContext();
+  isFirstTime = YES;
+	view.prepareContext(context, YES);  
+	equals(runCount, 2, 'did invoke renderMixin() from both mixins');
+
+  runCount = 0 ;
+  context = view.renderContext();
+  isFirstTime = NO;
+	view.prepareContext(context, NO);  
+	equals(runCount, 2, 'did invoke renderMixin() from both mixins');
+});
+

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/removeChild.js

@@ -0,0 +1,189 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: �2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same */
+
+// .......................................................
+// removeChild()
+//
+  
+var parent, child;
+module("SC.View#removeChild", {
+	setup: function() {
+		parent = SC.View.create({ childViews: [SC.View] });
+		child = parent.childViews[0];
+	}
+});
+
+test("returns receiver", function() {
+	equals(parent.removeChild(child), parent, 'receiver');
+});
+
+test("removes child from parent.childViews array", function() {
+  ok(parent.childViews.indexOf(child)>=0, 'precond - has child in childViews array before remove');
+  parent.removeChild(child);
+  ok(parent.childViews.indexOf(child)<0, 'removed child');
+});
+
+test("sets parentView property to null", function() {
+  ok(child.get('parentView'), 'precond - has parentView');
+  parent.removeChild(child);
+  ok(!child.get('parentView'), 'parentView is now null');
+});
+
+test("does nothing if passed null", function() {
+  
+  // monkey patch callbacks to make sure nothing runs.
+  var callCount = 0;
+  parent.willRemoveChild = parent.didRemoveChild = function() { callCount++; };
+  
+  parent.removeChild(null);
+  equals(callCount, 0, 'did not invoke callbacks');
+});
+
+test("invokes child.willRemoveFromParent before removing if defined", function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  child.willRemoveFromParent = function() {
+    // verify invoked BEFORE removal
+    equals(child.get('parentView'), parent, 'still in parent');
+    callCount++;
+  };
+  
+  parent.removeChild(child);
+  equals(callCount, 1, 'invoked callback');
+});
+
+test("invokes parent.willRemoveChild before removing if defined", function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  parent.willRemoveChild = function(view) {
+    equals(view, child, 'passed child as param');
+    
+    // verify invoked BEFORE removal
+    equals(child.get('parentView'), parent, 'still in parent');
+    callCount++;
+  };
+  
+  parent.removeChild(child);
+  equals(callCount, 1, 'invoked callback');
+});
+
+
+test("invokes child.didRemoveFromParent AFTER removing if defined", function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  child.didRemoveFromParent = function(view) {
+    equals(view, parent, 'passed parent as param');
+
+    // verify invoked AFTER removal
+    ok(!child.get('parentView'), 'no longer in parent');
+    callCount++;
+  };
+  
+  parent.removeChild(child);
+  equals(callCount, 1, 'invoked callback');
+});
+
+test("invokes parent.didRemoveChild before removing if defined", function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  parent.didRemoveChild = function(view) {
+    equals(view, child, 'passed child as param');
+    
+    // verify invoked BEFORE removal
+    ok(!child.get('parentView'), 'no longer in parent');
+    callCount++;
+  };
+  
+  parent.removeChild(child);
+  equals(callCount, 1, 'invoked callback');
+});
+
+test("invokes parentViewDidChange() on child view.  this is used by the view internals to update layer loc", function() {
+
+	// monkey patch to test
+	var callCount = 0;
+	child.parentViewDidChange = function() { callCount++; };
+	
+	parent.removeChild(child);
+	equals(callCount, 1, 'invoked parentViewDidChange');
+});
+
+// VERIFY LAYER CHANGES ARE DEFERRED
+test("should not move layer immediately", function() {
+
+  parent.createLayer();
+
+	var parentLayer = parent.get('layer'), childLayer = child.get('layer');  
+  ok(parentLayer, 'precond - parent has layer');
+  ok(childLayer, 'precond - child has layer');
+  equals(childLayer.parentNode, parentLayer, 'child layer belong to parent');
+  
+  parent.removeChild(child);
+  equals(childLayer.parentNode, parentLayer, 'child layer belong to parent');
+});
+
+// .......................................................
+// removeAllChildren()
+//
+var view;
+module("SC.View#removeAllChildren", {
+ setup: function() { 
+  view = SC.View.create({
+    childViews: [SC.View, SC.View, SC.View]
+  });
+ }
+});
+
+test("removes all child views", function() {
+  equals(view.childViews.length, 3, 'precond - has child views');
+  
+  view.removeAllChildren();
+  equals(view.childViews.length, 0, 'removed all children');
+});
+
+test("returns receiver", function() {
+	equals(view.removeAllChildren(), view, 'receiver');
+});
+  
+// .......................................................
+// removeFromParent()
+//
+module("SC.View#removeFromParent");
+
+test("removes view from parent view", function() {
+  var parent = SC.View.create({ childViews: [SC.View] });
+  var child = parent.childViews[0];
+  ok(child.get('parentView'), 'precond - has parentView');
+  
+  child.removeFromParent();
+  ok(!child.get('parentView'), 'no longer has parentView');
+  ok(parent.childViews.indexOf(child)<0, 'no longer in parent childViews');
+});
+
+test("returns receiver", function() {
+	equals(child.removeFromParent(), child, 'receiver');
+});
+
+test("does nothing if not in parentView", function() {
+  var callCount = 0;
+  var child = SC.View.create();
+
+	// monkey patch for testing...
+	child.willRemoveFromParent = function() { callCount++; };  
+	ok(!child.get('parentView'), 'precond - has no parent');
+	
+	child.removeFromParent();
+	equals(callCount, 0, 'did not invoke callback');
+});
+
+
+

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/render.js

@@ -0,0 +1,83 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: �2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same */
+
+// .......................................................
+//  render() 
+//
+module("SC.View#render");
+
+test("default implementation invokes renderChildViews if firstTime = YES", function() {
+
+	var runCount = 0, curContext, curFirstTime;
+	var view = SC.View.create({
+		renderChildViews: function(context, firstTime) {
+	  	equals(context, curContext, 'passed context');
+	  	equals(firstTime, curFirstTime, 'passed firstTime flag');
+	  	runCount++;
+		}
+	});
+	
+	// VERIFY firstTime = YES
+	curContext = view.renderContext();
+	curFirstTime = YES ;
+	view.render(curContext, curFirstTime);
+	equals(runCount, 1, 'did invoke renderChildViews()');
+
+	// VERIFY firstTime = NO
+	runCount = 0 ;
+	curContext = view.renderContext();
+	curFirstTime = NO ;
+	view.render(curContext, curFirstTime);
+	equals(runCount, 0, 'did NOT invoke renderChildViews()');
+		
+});
+  
+// .......................................................
+// renderChildViews() 
+//
+  
+module("SC.View#renderChildViews");
+
+test("creates a context and then invokes prepareContext on each childView", function() {
+
+	var runCount = 0, curContext, curFirstTime ;
+	
+	var ChildView = SC.View.extend({
+	  prepareContext: function(context, firstTime) {
+	  	equals(context.prevObject, curContext, 'passed child context of curContext');
+	  	equals(firstTime, curFirstTime, 'passed first time flag');
+	  	
+	  	equals(context.tagName(), this.get('tagName'), 'context setup with current tag name');
+	  	
+	  	runCount++; // record run
+	  }
+	});
+	
+	var view = SC.View.create({
+		childViews: [
+			ChildView.extend({ tagName: 'foo' }),
+			ChildView.extend({ tagName: 'bar' }),
+			ChildView.extend({ tagName: 'baz' })
+		]
+	});
+
+	// VERIFY: firstTime= YES 	
+	curContext = view.renderContext('div');
+	curFirstTime= YES ;
+	equals(view.renderChildViews(curContext, curFirstTime), curContext, 'returns context');
+	equals(runCount, 3, 'prepareContext() invoked for each child view');
+	
+
+	// VERIFY: firstTime= NO 	
+	runCount = 0 ; //reset
+	curContext = view.renderContext('div');
+	curFirstTime= NO ;
+	equals(view.renderChildViews(curContext, curFirstTime), curContext, 'returns context');
+	equals(runCount, 3, 'prepareContext() invoked for each child view');
+
+});

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/replaceChild.js

@@ -0,0 +1,29 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: �2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same */
+
+var parent, child;
+module("SC.View#replaceChild", {
+	setup: function() {
+	  child = SC.View.create();
+	  parent = SC.View.create({
+	    childViews: [SC.View, SC.View, SC.View]
+	  });		
+	}
+});
+
+
+test("swaps the old child with the new child", function() {
+  var oldChild = parent.childViews[1];
+
+  parent.replaceChild(child, oldChild);
+  equals(child.get('parentView'), parent, 'child has new parent');
+  ok(!oldChild.get('parentView'), 'old child no longer has parent');
+  
+  equals(parent.childViews[1], child, 'parent view has new child at loc 1');
+  equals(parent.childViews.length, 3, 'parent has same number of children');
+});

data/frameworks/sproutcore/frameworks/foundation/tests/views/view/updateLayer.js

@@ -0,0 +1,142 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Apple, Inc. and contributors.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+/*global module test equals context ok same */
+
+// NOTE: This file tests both updateLayer() and the related methods that 
+// will trigger it.
+
+// ..........................................................
+// TEST: updateLayer()
+// 
+module("SC.View#updateLayer");
+
+test("invokes prepareContext() and then updates layer element", function() {
+  var layer = document.createElement('div');
+  var view = SC.View.create({
+    layer: layer, // fake it...
+    prepareContext: function(context) {
+      context.addClass('did-update');
+    }
+  });
+  
+  view.updateLayer();
+  ok(layer.getAttribute('class').toString().indexOf('did-update')>=0, 'has class name added by prepareContext()');
+});
+
+// ..........................................................
+// TEST: updateLayerIfNeeded()
+// 
+var view, callCount ;
+module("SC.View#updateLayerIfNeeded", {
+  setup: function() {
+    // setup a fake view class so that updateLayerIfNeeded() will call
+    // updateLayer() if needed.  updateLayer() is faked to isolate test
+    view = SC.View.create({
+      isVisibleInWindow: YES,
+      layerNeedsUpdate: YES,
+      updateLayer: function() { callCount++; }
+    });
+    callCount = 0 ;
+  }
+  
+});
+
+test("does not call updateLayer if layerNeedsUpdate is NO", function() {
+  view.set('layerNeedsUpdate', NO);
+  view.updateLayerIfNeeded();
+  equals(callCount, 0, 'updateLayer did NOT run');
+});
+
+test("does not call updateLayer if isVisibleInWindow is NO", function() {
+  view.set('isVisibleInWindow', NO);
+  view.updateLayerIfNeeded();
+  equals(callCount, 0, 'updateLayer did NOT run');
+});
+
+test("does call updateLayer() if isVisible & layerNeedsUpdate", function() {
+  equals(view.get('isVisibleInWindow'), YES, 'precond - isVisibleInWindow');
+  equals(view.get('layerNeedsUpdate'), YES, 'precond - layerNeedsUpdate');
+  
+  view.updateLayerIfNeeded();
+  ok(callCount > 0, 'updateLayer() did run');
+});
+
+test("resets layerNeedsUpdate to NO if called", function() {
+  equals(view.get('layerNeedsUpdate'), YES, 'precond - layerNeedsUpdate');
+  view.updateLayerIfNeeded();
+  equals(view.get('layerNeedsUpdate'), NO, 'layerNeedsUpdate reset to NO');
+});
+
+test("returns receiver", function() {
+  equals(view.updateLayerIfNeeded(), view, 'returns receiver');
+});
+
+test("only runs updateLayer() once if called multiple times (since layerNeedsUpdate is set to NO)", function() {
+  callCount = 0;
+  view.updateLayerIfNeeded().updateLayerIfNeeded().updateLayerIfNeeded();
+  equals(callCount, 1, 'updateLayer() called only once');
+});
+
+// ..........................................................
+// TEST: layerNeedsUpdate auto-trigger
+// 
+module("SC.View#layerNeedsUpdate auto-triggers", {
+  setup: function() {
+    // use fake method to isolate call...
+    view = SC.View.create({
+      updateLayerIfNeeded: function() { callCount++; }
+    });
+    callCount = 0;
+  }
+});
+
+test("setting layerNeedsUpdate calls updateLayerIfNeeded at end of runloop", function() {
+  SC.RunLoop.begin();
+  view.set('layerNeedsUpdate', YES);
+  SC.RunLoop.end();
+  
+  equals(callCount, 1, 'updateLayerIfNeeded did run');  
+});
+
+test("setting & resetting only triggers updateLayerIfNeeded once per runloop", function() {
+  SC.RunLoop.begin();
+  view.set('layerNeedsUpdate', YES)
+      .set('layerNeedsUpdate', NO)
+      .set('layerNeedsUpdate', YES);
+  SC.RunLoop.end();
+  
+  equals(callCount, 1, 'updateLayerIfNeeded did run');  
+});
+
+// ..........................................................
+// INTEGRATION SCENARIOS
+// 
+
+module("SC.View#updateLayer - integration");
+
+test("layerNeedsUpdate actually triggers updateLayer", function() {
+  var callCount = 0 ;
+  var view = SC.View.create({
+    isVisibleInWindow: YES,
+    updateLayer: function() { callCount++; }
+  });
+  
+  SC.RunLoop.begin();
+  view.set('layerNeedsUpdate', YES);
+  SC.RunLoop.end();
+  
+  equals(callCount, 1, 'updateLayer did run b/c layerNeedsUpdate is YES');
+  callCount = 0 ;
+  
+  SC.RunLoop.begin();
+  view.set('layerNeedsUpdate', YES);
+  view.set('layerNeedsUpdate', NO);
+  SC.RunLoop.end();
+  
+  equals(callCount, 0, 'updateLayer did NOT run b/c layerNeedsUpdate is NO');
+});
+