sproutit-sproutcore 1.0.0.20090407205609 → 1.0.0.20090408130025

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

@@ -0,0 +1,97 @@
+// ==========================================================================
+// 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 Q$ */
+
+// ..........................................................
+// createLayer()
+// 
+module("SC.View#createLayer");
+
+test("returns the receiver", function() {
+  var v= SC.View.create();
+  equals(v.createLayer(), v, 'returns receiver');
+});
+
+test("calls prepareContext() and sets layer to resulting element", function() {
+  var v= SC.View.create({
+    tagName: 'span',
+    
+    prepareContext: function(context, firstTime) {
+      context.push("foo");
+    }
+  });
+  
+  equals(v.get('layer'), null, 'precondition - has no layer');
+  v.createLayer();
+  
+  var elem = v.get('layer');
+  ok(!!elem, 'has element now');
+  equals(elem.innerHTML, 'foo', 'has innerHTML from context');
+  equals(elem.tagName.toString().toLowerCase(), 'span', 'has tagName from view');
+  elem = null ;
+});
+
+test("invokes didCreateLayer() on receiver and all child views", function() {
+  var callCount = 0, mixinCount = 0;
+  var v= SC.View.create({
+    
+    didCreateLayer: function() { callCount++; },
+    didCreateLayerMixin: function() { mixinCount++; },
+    
+    childViews: [SC.View.extend({
+      didCreateLayer: function() { callCount++; },
+      childViews: [SC.View.extend({
+        didCreateLayer: function() { callCount++; },
+        didCreateLayerMixin: function() { mixinCount++; }
+      }), SC.View.extend({ /* no didCreateLayer */ })]
+    })]
+  });
+  
+  // verify setup...
+  ok(v.didCreateLayer, 'precondition - has root');
+  ok(v.childViews[0].didCreateLayer, 'precondition - has firstChild');
+  ok(v.childViews[0].childViews[0].didCreateLayer, 'precondition - has nested child');
+  ok(!v.get('layer'), 'has no layer');
+
+  v.createLayer();
+  equals(callCount, 3, 'did invoke all methods');
+  equals(mixinCount, 2, 'did invoke all mixin methods');
+});
+
+test("generated layer include HTML from child views as well", function() {
+  var v = SC.View.create({
+    childViews: [ SC.View.extend({ layerId: "foo" })]
+  });
+  
+  v.createLayer();
+  ok(Q$('#foo', v.get('layer')).get(0), 'has element with child layerId');
+});
+
+test("does NOT assign layer to child views immediately", function() {
+  var v = SC.View.create({
+    childViews: [ SC.View.extend({ layerId: "foo" })]
+  });
+  v.createLayer();
+  ok(!v.childViews[0]._view_layer, 'has no layer yet');
+});
+
+// ..........................................................
+// USE CASES
+// 
+
+// when view is first created, createLayer is NOT called
+
+// when view is added to parent view, and parent view is already visible in
+// window, layer is created just before adding it to the DOM
+
+// when a pane is added to the window, the pane layer is created.
+
+// when a pane with an exiting layer is removed from the DOM, the layer is removed from the DOM, but it is not destroyed.
+
+// what if we move a view from a parentView that has a layer to a parentView that does NOT have a layer.   Delete layer.
+
+// what if a move a view from a parentView that does NOT have a layer to a parentView that DOES have a layer.

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

@@ -0,0 +1,85 @@
+// ==========================================================================
+// 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 Q$ */
+
+module("SC.View#destroyLayer");
+
+test("it if has no layer, does nothing", function() {
+  var callCount = 0;
+  var view = SC.View.create({ 
+    willDestroyLayer: function() { callCount++; }
+  });
+  ok(!view.get('layer'), 'precond - does NOT have layer');
+  
+  view.destroyLayer();
+  equals(callCount, 0, 'did not invoke callback');
+});
+
+test("if it has a layer, calls willDestroyLayer on receiver and child views then deletes the layer", function() {
+  var callCount = 0;
+  
+  var view = SC.View.create({
+    willDestroyLayer: function() { callCount++; },
+    childViews: [SC.View.extend({
+      // no willDestroyLayer here... make sure no errors are thrown
+      childViews: [SC.View.extend({
+        willDestroyLayer: function() { callCount++; }
+      })]
+    })]
+  });
+  view.createLayer();
+  ok(view.get('layer'), 'precond - view has layer');
+  
+  view.destroyLayer();
+  equals(callCount, 2, 'invoked destroy layer');  
+  ok(!view.get('layer'), 'view no longer has layer');
+});
+
+test("if it has a layer, calls willDestroyLayerMixin on receiver and child views if defined (comes from mixins)", function() {
+  var callCount = 0;
+
+  // make sure this will call both mixins...
+  var mixinA = {
+    willDestroyLayerMixin: function() { callCount++; }
+  };
+  
+  var mixinB = {
+    willDestroyLayerMixin: function() { callCount++; }
+  };
+  
+  var view = SC.View.create(mixinA, mixinB, {
+    childViews: [SC.View.extend(mixinA, mixinB, {
+      childViews: [SC.View.extend(mixinA)]
+    })]
+  });
+  view.createLayer();
+  view.destroyLayer();
+  equals(callCount, 5, 'invoked willDestroyLayerMixin on all mixins');  
+});
+
+test("returns receiver", function() {
+  var view = SC.View.create().createLayer();
+  equals(view.destroyLayer(), view, 'returns receiver');
+});
+
+test("removes layer from parentNode if in DOM", function() {
+  var view = SC.View.create();
+  var layer = view.createLayer().get('layer');
+  
+  ok(layer, 'precond - has layer');
+  document.body.appendChild(layer); // add to document body
+  
+  view.destroyLayer();
+
+  if(layer.parentNode)
+    equals(layer.parentNode.nodeType, 11, 'layer no longer in parent node');
+  else
+    equals(layer.parentNode, null, 'layer no longer in parent node');
+  layer = null; // cleanup
+});
+
+

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

@@ -0,0 +1,52 @@
+// ==========================================================================
+// 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 */
+
+// ..........................................................
+// createChildViews()
+// 
+var view, parentDom, childDom, layerId ;
+module("SC.View#findLayerInParentLayer", {
+  setup: function() {
+    
+    layerId = 'foo-123';
+    
+    // manually construct a test layer.  next childDom a few layers deep
+    childDom = document.createElement('div');
+    childDom.setAttribute('id', layerId);
+    
+    var intermediate = document.createElement('div');
+    intermediate.appendChild(childDom);
+    
+    parentDom = document.createElement('div');
+    parentDom.appendChild(intermediate);
+    intermediate = null;
+    
+    
+    // setup view w/ layerId
+    view = SC.View.create({ layerId: layerId });
+  },
+  
+  teardown: function() {
+    view = parentDom = childDom = layerId = null;
+  }
+});
+
+test("discovers layer by finding element with matching layerId - when DOM is in document already", function() {
+  document.body.appendChild(parentDom);
+  equals(view.findLayerInParentLayer(parentDom), childDom, 'found childDom');
+  document.body.removeChild(parentDom); // cleanup or else next test may fail
+});
+
+test("discovers layer by finding element with matching layerId - when parent DOM is NOT in document", function() {
+  if(parentDom.parentNode)
+      equals(parentDom.parentNode.nodeType, 11, 'precond - NOT in parent doc');
+  else    
+    equals(parentDom.parentNode, null, 'precond - NOT in parent doc');
+  equals(view.findLayerInParentLayer(parentDom), childDom, 'found childDom');
+});
+

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

@@ -0,0 +1,50 @@
+// ==========================================================================
+// 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#init");
+
+test("registers view in the global views hash using layerId for event targeted", function() {
+  var v = SC.View.create();
+  equals(SC.View.views[v.get('layerId')], v, 'registers view');
+});
+
+test("adds displayDidChange observer on all display properties", function() {
+  var didChange = NO ;
+  var v = SC.View.create({
+    // override just to make sure the registration works...
+    displayDidChange: function() { didChange = YES ; },
+    
+    displayProperties: 'foo bar'.w(),
+    
+    foo: 'foo',
+    bar: 'bar'
+  });
+  
+  v.set('foo', 'baz');
+  ok(didChange, 'didChange on set(foo)');
+  didChange = NO ;
+  
+  v.set('bar', 'baz');
+  ok(didChange, 'didChange on set(bar)');
+});
+
+test("invokes createChildViews()", function() {
+  var didInvoke = NO ;
+  var v = SC.View.create({
+    // override just for test
+    createChildViews: function() { didInvoke = YES; }
+  });
+  ok(didInvoke, 'did invoke createChildViews()');
+});
+
+test("does NOT create layer", function() {
+  var v = SC.View.create();
+  equals(v.get('layer'), null, 'did not create layer');  
+});
+
+

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

@@ -0,0 +1,200 @@
+// ==========================================================================
+// 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#insertBefore", {
+	setup: function() {
+	  child = SC.View.create();
+	  parent = SC.View.create({
+	    childViews: [SC.View]
+	  });		
+	}
+});
+
+test("returns receiver", function() {
+  equals(parent.insertBefore(child, null), parent, 'receiver');
+});
+
+test("makes set child.parentView = to new parent view", function() {
+	ok(child.get('parentView')!==parent, 'precond - parent is not child.parentView yet');
+	
+	// add observer to make sure property change triggers 
+	var callCount = 0;
+	child.addObserver('parentView', function() {
+	  callCount++;
+	});
+	
+	parent.insertBefore(child, null);
+	equals(child.get('parentView'), parent, 'parent is child.parentView');
+	equals(callCount, 1, 'observer did fire');
+});
+
+test("insertBefore(child, null) appends child to end of parent.childView's array", function() {
+	parent.insertBefore(child, null);
+	equals(parent.childViews[parent.childViews.length-1], child, 'child is last childView');
+});
+
+test("insertBefore(child, otherChild) inserts child before other child view", function() {
+  
+  var otherChild = parent.childViews[0]; // get current first child
+  ok(otherChild, 'precond - otherChild is not null')
+  parent.insertBefore(child, otherChild);
+  equals(parent.childViews[0], child, 'child inserted before other child');
+});
+
+test("if child belongs to another parent view, child will be removed from other parent when added to new parent", function() {
+
+	// create child view that belongs to a parent already
+  var oldParent = SC.View.create({ childViews:[SC.View] });
+  child = oldParent.childViews[0];
+  
+	ok(child, 'precond - got child');
+  ok(child.get('parentView'), 'precond - child has a parent view');  
+  
+  parent.insertBefore(child, null);
+  ok(oldParent.childViews.indexOf(child)<0, 'oldParent no longer has childView');
+  equals(child.get('parentView'), parent, 'child has new parent view');
+});
+
+test("invokes willAddChild() on receiver if defined before adding child" ,function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  var otherChild = parent.childViews[0];
+  parent.willAddChild = function(newChild, beforeView) {
+  
+  	// verify params
+  	equals(newChild, child, 'passed newChild');
+  	equals(beforeView, otherChild, 'passed beforeView');
+  	
+  	// verify this is called BEFORE the view is added
+  	ok(parent.childViews.indexOf(child)<0, 'should not have child yet');
+  	ok(child.get('parentView')!==parent, 'childView not changed yet either');
+  	callCount++;
+  };
+
+	  
+  parent.insertBefore(child, otherChild);
+  ok(callCount, 1, 'invoked');
+});
+
+test("invokes willAddToParent() on child view if defined before adding child" ,function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  var otherChild = parent.childViews[0];
+  child.willAddToParent = function(parentView, beforeView) {
+  
+  	// verify params
+  	equals(parentView, parent, 'passed parent');
+  	equals(beforeView, otherChild, 'passed beforeView');
+  	
+  	// verify this is called BEFORE the view is added
+  	ok(parent.childViews.indexOf(child)<0, 'should not have child yet');
+  	ok(child.get('parentView')!==parent, 'childView not changed yet either');
+  	callCount++;
+  };
+
+	  
+  parent.insertBefore(child, otherChild);
+  ok(callCount, 1, 'invoked');
+});
+
+test("invokes didAddChild() on receiver if defined after adding child" ,function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  var otherChild = parent.childViews[0];
+  parent.didAddChild = function(newChild, beforeView) {
+  
+  	// verify params
+  	equals(newChild, child, 'passed newChild');
+  	equals(beforeView, otherChild, 'passed beforeView');
+  	
+  	// verify this is called AFTER the view is added
+  	ok(parent.childViews.indexOf(child)>=0, 'should have child');
+  	ok(child.get('parentView')===parent, 'childView should have new parentView');
+  	callCount++;
+  };
+
+	  
+  parent.insertBefore(child, otherChild);
+  ok(callCount, 1, 'invoked');
+});
+
+test("invokes didAddToParent() on child view if defined after adding child" ,function() {
+
+  // monkey patch to test
+  var callCount = 0;
+  var otherChild = parent.childViews[0];
+  child.didAddToParent = function(parentView, beforeView) {
+  
+  	// verify params
+  	equals(parentView, parent, 'passed parent');
+  	equals(beforeView, otherChild, 'passed beforeView');
+  	
+  	// verify this is called AFTER the view is added
+  	ok(parent.childViews.indexOf(child)>=0, 'should have child');
+  	ok(child.get('parentView')===parent, 'childView should have new parentView');
+  	callCount++;
+  };
+
+	  
+  parent.insertBefore(child, otherChild);
+  ok(callCount, 1, 'invoked');
+});
+
+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.insertBefore(child, null);
+	equals(callCount, 1, 'invoked parentViewDidChange');
+});
+
+// VERIFY LAYER CHANGES ARE DEFERRED
+test("should not move layer immediately", function() {
+
+  parent.createLayer();
+  child.createLayer();
+  
+  ok(parent.get('layer'), 'precond - parent has layer');
+  ok(child.get('layer'), 'precond - child has layer');
+  
+  parent.insertBefore(child, null);
+  ok(child.get('layer').parentNode !== parent.get('layer'), 'did not move layer');
+  
+});
+
+// .......................................................
+// appendChild()
+//
+
+module('SC.View#appendChild', {
+  setup: function() {
+    parent = SC.View.create({
+      childViews: [SC.View, SC.View] 
+    });
+    
+    child = SC.View.create();
+  }
+});
+
+test("returns receiver", function() {
+  equals(parent.appendChild(child, null), parent, 'receiver');
+});
+
+  
+test("should add child to end of childViews", function() {
+  parent.appendChild(child);
+  equals(parent.childViews[parent.childViews.length-1], child, 'child is last child view');
+});
+
+

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

@@ -0,0 +1,102 @@
+// ========================================================================
+// View metrics Unit Tests
+// ========================================================================
+/*globals module test ok isObj equals expects */
+
+/**
+  These tests verify that all view metrics -- frame, clippingFrame,
+  isVisibleInWindow, etc. are correct.
+*/
+
+// ..........................................................
+// BASE TESTS
+// 
+// These tests exercise the API.  See below for tests that cover edge 
+// conditions.  If you find a bug, we recommend that you add a test in the 
+// edge case section.
+
+var FRAME = { x: 10, y: 10, width: 30, height: 30 } ;
+
+var pane, view ; // test globals
+
+module("isVisibleInWindow", {
+  
+  setup: function() {
+    pane = SC.MainPane.create() ;
+    pane.append() ;
+    view = SC.View.create() ; 
+  },
+  
+  teardown: function() {
+    view = null ;
+    pane.remove() ;
+    pane = null ;
+  }
+  
+});
+
+test("a new view should not be visible initially", function() {
+  ok(!view.get('isVisibleInWindow'), "view.get('isVisibleInWindow') === NO") ;
+});
+
+test("adding a new view to a visible pane should make it visible", function() {
+  ok(!view.get('isVisibleInWindow'), "view.get('isVisibleInWindow') === NO") ;
+  ok(pane.get('isVisibleInWindow'), "pane.get('isVisibleInWindow') === YES") ;
+  
+  pane.appendChild(view) ;
+  ok(view.get('isVisibleInWindow'), "after pane.appendChild(view), view.get('isVisibleInWindow') === YES") ;
+});
+
+test("removing a view from a visible pane should make it invisible again", function() {
+  ok(!view.get('isVisibleInWindow'), "view.get('isVisibleInWindow') === NO") ;
+  ok(pane.get('isVisibleInWindow'), "pane.get('isVisibleInWindow') === YES") ;
+  pane.appendChild(view) ;
+  ok(view.get('isVisibleInWindow'), "after pane.appendChild(view), view.get('isVisibleInWindow') === YES") ;
+  
+  view.removeFromParent() ;
+  ok(!view.get('isVisibleInWindow'), "after view.removeFromParent(), view.get('isVisibleInWindow') === NO") ;
+});
+
+// .......................................................
+// integration with updateLayer and layoutChildViews 
+//
+test("updateLayer should not be invoked even if layer becomes dirty until isVisibleInWindow changes, then it should invoke", function() {
+
+	var callCount = 0 ;
+	view.updateLayer = function() { callCount++; };
+	ok(!view.get('isVisibleInWindow'), 'precond - view should not be visible to start');
+	
+	SC.RunLoop.begin();
+	view.displayDidChange();
+	SC.RunLoop.end();
+	equals(callCount, 0, 'updateLayer should not run b/c its not visible');
+	
+	SC.RunLoop.begin();
+	pane.appendChild(view); // make visible in window...
+	ok(view.get('isVisibleInWindow'), 'view should now be visible in window');
+	SC.RunLoop.end();
+	equals(callCount, 1, 'updateLayer should exec now b/c isVisibleInWindow is YES');
+});
+
+test("layoutChildViewsIfNeeded should not be invoked even if layer needs layout until isVisibleInWindow changes, then it should invoke", function() {
+
+	var child = SC.View.create();
+	view.appendChild(child);
+	
+	var callCount = 0 ;
+	view.layoutChildViews = function() { callCount++; };
+	ok(!view.get('isVisibleInWindow'), 'precond - view should not be visible to start');
+	
+	SC.RunLoop.begin();
+	view.layoutDidChangeFor(child);
+	SC.RunLoop.end();
+	equals(callCount, 0, 'layoutChildViews should not run b/c its not visible');
+	
+	SC.RunLoop.begin();
+	pane.appendChild(view); // make visible in window...
+	ok(view.get('isVisibleInWindow'), 'view should now be visible in window');
+	SC.RunLoop.end();
+	equals(callCount, 1, 'layoutChildViews should exec now b/c isVisibleInWindow is YES');
+});
+
+