sproutit-sproutcore 1.0.0.20090416161445 → 1.0.0.20090720093355

data/frameworks/sproutcore/frameworks/desktop/tests/views/collection/deleteSelection.js

@@ -0,0 +1,82 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            portions copyright @2009 Apple, Inc.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+var view, sel, beforeLen, afterLen, content ;
+
+module("SC.CollectionView.deleteSelection", {
+  setup: function() {
+
+    content = "1 2 3 4 5 6 7 8 9 10".w().map(function(x) {
+      return SC.Object.create({ title: x });
+    });
+
+    sel  = SC.SelectionSet.create().add(content,4,2);
+
+    view = SC.CollectionView.create({
+      content: content,
+      selection: sel,
+      canDeleteContent: YES
+    });
+    
+    beforeLen = content.get('length');
+    afterLen  = beforeLen - sel.get('length');
+  }
+});
+
+// ..........................................................
+// BASIC OPERATIONS
+// 
+
+test("canDeleteContent", function() {
+  
+  view.set('canDeleteContent', NO);
+  equals(view.deleteSelection(), NO, 'should return NO if not allowed');
+  equals(content.get('length'), beforeLen, 'content.length should not change');
+  equals(view.get('selection').get('length'), 2, 'should not change selection');
+  
+  view.set('canDeleteContent', YES);
+  equals(view.deleteSelection(), YES, 'should return YES if allowed');
+  equals(content.get('length'), afterLen, 'content.length should change');
+  equals(view.get('selection').get('length'), 0, 'should have empty selection');
+});
+
+test("empty selection case", function() {
+  view.select(null); // clear selection
+  view.set('canDeleteContent', YES);
+  equals(view.get('selection').get('length'), 0, 'precond - should have empty selection');
+
+  equals(view.deleteSelection(), NO, 'should return NO if not allowed');
+  equals(content.get('length'), beforeLen, 'content.length should not change');
+});
+
+test("delegate.collectionViewShouldDeleteIndexes", function() {
+  view.set('canDeleteContent', YES);
+  view.delegate = SC.Object.create(SC.CollectionViewDelegate, {
+    
+    v: null,
+    
+    collectionViewShouldDeleteIndexes: function() { return this.v; }
+  });
+
+  // delegate returns NO
+  equals(view.deleteSelection(), NO, 'should return NO if not allowed');
+  equals(content.get('length'), beforeLen, 'content.length should not change');
+  equals(view.get('selection').get('length'), 2, 'should not change selection');
+  
+  // delegate returns partial
+  view.delegate.v = SC.IndexSet.create(4,1);
+  equals(view.get('selectionDelegate'), view.delegate, 'selection delegate should be delegate object');
+  equals(view.deleteSelection(), YES, 'should return YES if allowed');
+  equals(content.get('length'), afterLen+1, 'content.length should change');
+  equals(view.get('selection').get('length'), 1, 'non-deleted parts should remain selected %@'.fmt(view.get('selection')));
+});
+
+// ..........................................................
+// EDGE CASES
+// 
+
+// Add special edge cases here

data/frameworks/sproutcore/frameworks/desktop/tests/views/collection/deselect.js

@@ -0,0 +1,199 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            portions copyright @2009 Apple, Inc.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+var view, sel, content ;
+
+module("SC.CollectionView.deselect", {
+  setup: function() {
+    
+    content = "1 2 3 4 5 6 7 8 9 10".w().map(function(x) {
+      return SC.Object.create({ title: x });
+    });
+    
+    sel  = SC.SelectionSet.create().add(content,4,4);
+    
+    view = SC.CollectionView.create({
+      content: content, 
+      selection: sel
+    });
+  }
+});
+
+// ..........................................................
+// BASIC OPERATIONS
+// 
+
+test("delect(indexes=Number)", function() {
+  var expected = SC.SelectionSet.create().add(content,4,4).remove(content,6),
+      actual ;
+      
+  SC.run(function() { view.deselect(6); });
+  
+  actual = view.get('selection');
+  ok(expected.isEqual(actual), 'selection should remove index (expected: %@ actual: %@)'.fmt(expected, actual));
+});
+
+
+test("delect(indexes=IndexSet)", function() {
+  var actual, expected = SC.SelectionSet.create()
+                                .add(content,4,4).remove(content,6,2);
+      
+  SC.run(function() { view.deselect(SC.IndexSet.create(6,2)); });
+  
+  actual = view.get('selection');
+  ok(expected.isEqual(actual), 'selection should remove index (expected: %@ actual: %@)'.fmt(expected, actual));
+});
+
+
+test("delect() with empty selection", function() {
+  var expected = SC.SelectionSet.create(),
+      actual ;
+
+  SC.run(function() { view.set('selection', expected); });
+  SC.run(function() { view.deselect(SC.IndexSet.create(6,2)); });
+  
+  actual = view.get('selection');
+  ok(expected.isEqual(actual), 'deselect should do nothing (expected: %@ actual: %@)'.fmt(expected, actual));
+});
+
+// ..........................................................
+// DELEGATE TESTS
+// 
+
+var del;
+
+module("SC.CollectionView.deselect - delegate support", {
+  setup: function() {
+
+    content = "1 2 3 4 5 6 7 8 9 10".w().map(function(x) {
+      return SC.Object.create({ title: x });
+    });
+
+    del  = SC.Object.create(SC.CollectionViewDelegate);
+    sel  = SC.SelectionSet.create().add(content, 4,4);
+    view = SC.CollectionView.create({
+      delegate: del,
+      selection: sel,
+      content: content
+    });
+  }
+});
+
+test("should call delegate if set", function() {
+  var callCount1 = 0, callCount2 = 0 ;
+  del.collectionViewShouldDeselectIndexes = function(v, indexes, extend) { 
+    callCount1++; 
+    return indexes;
+  };
+
+  del.collectionViewSelectionForProposedSelection = function(v, indexes) { 
+    callCount2++; 
+    return indexes ;
+  };
+  
+  view.deselect(3);
+  equals(callCount1, 1, 'should invoke collectionViewShouldDeselectIndexes on delegate 1x');
+  equals(callCount2, 1, 'should invoke collectionViewSelectionForProposedSelection on delegate 1x if change is allowed');
+  
+});
+
+test("not calling collectionViewSelectionForProposedSelection if collectionViewShouldDeselectIndexes returns null", function() {
+  var callCount1 = 0, callCount2 = 0 ;
+  del.collectionViewShouldDeselectIndexes = function(v, indexes, extend) { 
+    callCount1++; 
+    return null;
+  };
+
+  del.collectionViewSelectionForProposedSelection = function(v, indexes) { 
+    callCount2++; 
+    return indexes ;
+  };
+  
+  view.deselect(3);
+  equals(callCount1, 1, 'should invoke collectionViewShouldDeselectIndexes on delegate 1x');
+  equals(callCount2, 0, 'should NOT invoke collectionViewSelectionForProposedSelection on delegate since no change was allowed');
+  
+});
+
+test("del.collectionViewShouldDeselectIndexes - replacing selection", function() {
+
+  del.collectionViewShouldDeselectIndexes = function(v, indexes, extend) { 
+    return indexes.without(3);
+  };
+  view.deselect(SC.IndexSet.create(0,4));
+  
+  var expected = sel.copy().remove(content,SC.IndexSet.create(0,4).remove(3)),
+      actual   = view.get('selection');
+  ok(expected.isEqual(actual), 'selection should only include those allowed by delegate (i.e. not index 3) (expected: %@ actual: %@)'.fmt(expected, actual));
+  
+});
+
+test("del.collectionViewShouldDeselectIndexes - returns empty index set", function() {
+
+  del.collectionViewShouldDeselectIndexes = function(v, indexes) { 
+    return indexes.without(5);
+  };
+
+  view.deselect(4);
+  view.deselect(5); // should be ignored
+  var expected = sel.copy().remove(content,4),
+      actual   = view.get('selection');
+  ok(expected.isEqual(actual), 'selection should deselect only items returned by delegate (expected: %@ actual: %@)'.fmt(expected, actual));
+
+});
+
+
+test("del.collectionViewShouldDeselectIndexes - delegate returns null", function() {
+
+  del.collectionViewShouldDeselectIndexes = function(v, indexes, extend) { 
+    return null;
+  };
+
+  view.deselect(4); // should be ignored
+  var expected = sel,
+      actual   = view.get('selection');
+  ok(expected.isEqual(actual), 'selection should not change if delegate returns null (expected: %@ actual: %@)'.fmt(expected, actual));
+  
+});
+
+
+test("del.collectionViewSelectionForProposedSelection - returns indexes", function() {
+
+  del.collectionViewSelectionForProposedSelection = function(v, indexes) { 
+
+    var expected = sel.copy().remove(content,5),
+        actual   = indexes;
+    ok(expected.isEqual(actual), 'should pass proposed selection to delegate (expected: %@ actual: %@)'.fmt(expected, actual));
+
+    equals(v, view, 'should pass view to delegate');
+
+    return SC.SelectionSet.create().add(content, 10,20);
+  };
+
+  view.deselect(5); // should be ignored
+  var expected = SC.SelectionSet.create().add(content, 10,20),
+      actual   = view.get('selection');
+  ok(expected.isEqual(actual), 'should set selection to whatever is returned from delegate (expected: %@ actual: %@)'.fmt(expected, actual));
+  
+});
+
+
+test("del.collectionViewSelectionForProposedSelection - returns null", function() {
+
+  del.collectionViewSelectionForProposedSelection = function(v, indexes) { 
+    return null;
+  };
+
+  view.deselect(5); // should be ignored
+  var expected = SC.SelectionSet.create(),
+      actual   = view.get('selection');
+  ok(expected.isEqual(actual), 'should set selection to empty set if returns null (expected: %@ actual: %@)'.fmt(expected, actual));
+  
+});
+
+
+

data/frameworks/sproutcore/frameworks/desktop/tests/views/collection/itemViewForContentIndex.js

@@ -0,0 +1,288 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
+//            portions copyright @2009 Apple, Inc.
+// License:   Licened under MIT license (see license.js)
+// ==========================================================================
+
+var view, del, content ;
+
+module("SC.CollectionView.itemViewForContentIndex", {
+  setup: function() {
+    content = "a b c".w().map(function(x) { 
+      return SC.Object.create({ title: x });
+    });
+    
+    del = {
+      fixture: {
+        isEnabled: YES,
+        isSelected: YES,
+        outlineLevel: 3,
+        disclosureState: SC.LEAF_NODE
+      },
+      
+      contentIndexIsEnabled: function() { 
+        return this.fixture.isEnabled; 
+      },
+      
+      contentIndexIsSelected: function() { 
+        return this.fixture.isSelected; 
+      },
+
+      contentIndexOutlineLevel: function() { 
+        return this.fixture.outlineLevel; 
+      },
+      
+      contentIndexDisclosureState: function() {
+        return this.fixture.disclosureState ;
+      }
+    };
+
+    // NOTE: delegate methods above are added here.
+    view = SC.CollectionView.create(del, {
+      content: content,
+      
+      layoutForContentIndex: function(contentIndex) {
+        return this.fixtureLayout ;
+      },
+      
+      fixtureLayout: { left: 0, right: 0, top:0, bottom: 0 },
+      
+      groupExampleView: SC.View.extend(), // custom for testing
+      
+      exampleView: SC.View.extend(), // custom for testing
+      
+      testAsGroup: NO,
+      
+      contentIndexIsGroup: function() { return this.testAsGroup; },
+      
+      contentGroupIndexes: function() {
+        if (this.testAsGroup) {
+          return SC.IndexSet.create(0, this.get('length'));
+        } else return null ;
+      },
+      
+      fixtureNowShowing: SC.IndexSet.create(0,3),
+      computeNowShowing: function() {
+        return this.fixtureNowShowing;
+      }
+      
+    });
+    
+    // add in delegate mixin
+    del = SC.mixin({}, SC.CollectionContent, del);
+    
+  }
+});
+
+function shouldMatchFixture(itemView, fixture) {
+  var key;
+  for(key in fixture) {
+    if (!fixture.hasOwnProperty(key)) continue;
+    equals(itemView.get(key), fixture[key], 'itemView.%@ should match delegate value'.fmt(key));
+  }
+}
+
+test("creating basic item view", function() {
+  var itemView = view.itemViewForContentIndex(1);
+  
+  // should use exampleView
+  ok(itemView, 'should return itemView');
+  ok(itemView.kindOf(view.exampleView), 'itemView %@ should be kindOf %@'.fmt(itemView, view.exampleView));
+  
+  // set added properties
+  equals(itemView.get('content'), content.objectAt(1), 'itemView.content should be set to content item');
+  equals(itemView.get('contentIndex'), 1, 'itemView.contentIndex should be set');
+  equals(itemView.get('owner'), view, 'itemView.owner should be collection view');
+  equals(itemView.get('displayDelegate'), view, 'itemView.displayDelegate should be collection view');
+  equals(itemView.get('parentView'), view, 'itemView.parentView should be collection view');
+  
+  // test data from delegate
+  shouldMatchFixture(itemView, view.fixture);
+});
+
+test("returning item from cache", function() {
+  
+  var itemView1 = view.itemViewForContentIndex(1);
+  ok(itemView1, 'precond - first call returns an item view');
+  
+  var itemView2 = view.itemViewForContentIndex(1);
+  equals(itemView2, itemView1, 'retrieving multiple times should same instance');
+
+  // Test internal case
+  var itemView3 = view.itemViewForContentIndex(1, YES);
+  ok(itemView1 !== itemView3, 'itemViewForContentIndex(1, YES) should return new item even if it is already cached actual :%@'.fmt(itemView3));
+
+  var itemView4 = view.itemViewForContentIndex(1, NO);
+  equals(itemView4, itemView3, 'itemViewForContentIndex(1) [no reload] should return newly cached item after recache');
+  
+});
+
+// ..........................................................
+// ALTERNATE WAYS TO GET AN EXAMPLE VIEW
+// 
+
+test("contentExampleViewKey is set and content has property", function() {
+  var CustomView = SC.View.extend();
+  var obj = content.objectAt(1);
+  obj.set('foo', CustomView);
+  view.set('contentExampleViewKey', 'foo');
+
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'should return item view');
+  ok(itemView.kindOf(CustomView), 'itemView should be custom view specified on object. actual: %@'.fmt(itemView));
+});
+
+test("contentExampleViewKey is set and content is null", function() {
+  var CustomView = SC.View.extend();
+  view.set('contentExampleViewKey', 'foo');
+  content.replace(1,1,[null]);
+
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'should return item view');
+  equals(itemView.get('content'), null, 'itemView content should be null');
+  ok(itemView.kindOf(view.exampleView), 'itemView should be exampleView (%@). actual: %@'.fmt(view.exampleView, itemView));
+});
+
+test("contentExampleViewKey is set and content property is empty", function() {
+  var CustomView = SC.View.extend();
+  view.set('contentExampleViewKey', 'foo');
+
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'should return item view');
+  equals(itemView.get('content'), content.objectAt(1), 'itemView should have content');
+  ok(itemView.kindOf(view.exampleView), 'itemView should be exampleView (%@). actual: %@'.fmt(view.exampleView, itemView));
+});
+
+// ..........................................................
+// GROUP EXAMPLE VIEW
+// 
+
+test("delegate says content is group", function() {
+  view.testAsGroup = YES ;
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'should return itemView');
+  ok(itemView.kindOf(view.groupExampleView), 'itemView should be groupExampleView (%@). actual: %@'.fmt(view.groupExampleView, itemView));
+  ok(itemView.isGroupView, 'itemView.isGroupView should be YES');
+});
+
+test("contentGroupExampleViewKey is set and content has property", function() {
+  view.testAsGroup = YES ;
+  
+  var CustomView = SC.View.extend();
+  var obj = content.objectAt(1);
+  obj.set('foo', CustomView);
+  view.set('contentGroupExampleViewKey', 'foo');
+
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'should return item view');
+  ok(itemView.kindOf(CustomView), 'itemView should be custom view specified on object. actual: %@'.fmt(itemView));
+  ok(itemView.isGroupView, 'itemView.isGroupView should be YES');
+});
+
+test("contentGroupExampleViewKey is set and content is null", function() {
+  view.testAsGroup = YES ;
+
+  var CustomView = SC.View.extend();
+  view.set('contentGroupExampleViewKey', 'foo');
+  content.replace(1,1,[null]);
+
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'should return item view');
+  equals(itemView.get('content'), null, 'itemView content should be null');
+  ok(itemView.kindOf(view.groupExampleView), 'itemView should be exampleView (%@). actual: %@'.fmt(view.groupExampleView, itemView));
+  ok(itemView.isGroupView, 'itemView.isGroupView should be YES');
+});
+
+test("contentGroupExampleViewKey is set and content property is empty", function() {
+  view.testAsGroup = YES ;
+
+  var CustomView = SC.View.extend();
+  view.set('contentGroupExampleViewKey', 'foo');
+
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'should return item view');
+  equals(itemView.get('content'), content.objectAt(1), 'itemView should have content');
+  ok(itemView.kindOf(view.groupExampleView), 'itemView should be exampleView (%@). actual: %@'.fmt(view.groupExampleView, itemView));
+  ok(itemView.isGroupView, 'itemView.isGroupView should be YES');
+});
+
+
+// ..........................................................
+// DELEGATE SUPPORT
+// 
+
+test("consults delegate if set", function() {
+  view.fixture = null; //break to make sure this is not used
+  view.delegate = del;
+  
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'returns item view');
+  shouldMatchFixture(itemView, del.fixture);
+});
+
+test("consults content if implements mixin and delegate not set", function() {
+  view.fixture = null; //break to make sure this is not used
+  view.delegate = null;
+  
+  SC.mixin(content, del) ; // add delegate methods to content
+  
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'returns item view');
+  shouldMatchFixture(itemView, content.fixture);
+});
+
+
+test("prefers delegate over content if both implement mixin", function() {
+  view.fixture = null; //break to make sure this is not used
+  view.delegate = del;
+  SC.mixin(content, del) ; // add delegate methods to content
+  content.fixture = null ; //break
+  
+  var itemView = view.itemViewForContentIndex(1);
+  ok(itemView, 'returns item view');
+  shouldMatchFixture(itemView, del.fixture);
+});
+
+// ..........................................................
+// SPECIAL CASES
+// 
+
+test("after making an item visible then invisible again", function() {
+
+  view.isVisibleInWindow = YES ;
+  
+  // STEP 1- setup with some nowShowing
+  SC.run(function() {
+    view.set('fixtureNowShowing', SC.IndexSet.create(1));
+    view.notifyPropertyChange('nowShowing');
+  });
+  equals(view.get('childViews').length, 1, 'precond - should have a child view');
+
+  var itemView = view.itemViewForContentIndex(1);
+  equals(itemView.get('parentView'), view, 'itemView has parent view');
+  
+  // STEP 2- setup with NONE visible
+  SC.run(function() {
+    view.set('fixtureNowShowing', SC.IndexSet.create());
+    view.notifyPropertyChange('nowShowing');
+  });
+  equals(view.get('childViews').length, 0, 'precond - should have no childview');
+
+  var itemView = view.itemViewForContentIndex(1);
+  equals(itemView.get('parentView'), view, 'itemView has parent view');
+
+
+  // STEP 3- go back to nowShowing
+  SC.run(function() {
+    view.set('fixtureNowShowing', SC.IndexSet.create(1));
+    view.notifyPropertyChange('nowShowing');
+  });
+  equals(view.get('childViews').length, 1, 'precond - should have a child view');
+
+  itemView = view.itemViewForContentIndex(1);
+  equals(itemView.get('parentView'), view, 'itemView has parent view');
+  
+});
+
+