sproutit-sproutcore 1.0.203 → 1.0.20090721145236

data/frameworks/sproutcore/frameworks/foundation/controllers/object.js

@@ -1,323 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
-//            Portions ©2008-2009 Apple, Inc. All rights reserved.
-// License:   Licened under MIT license (see license.js)
-// ==========================================================================
-
-require('controllers/controller') ;
-
-/** @class
-
-  An ObjectController gives you a simple way to manage the editing state of
-  an object.  You can use an ObjectController instance as a "proxy" for your
-  model objects.
-  
-  Any properties you get or set on the object controller, will be passed 
-  through to its content object.  This allows you to setup bindings to your
-  object controller one time for all of your views and then swap out the 
-  content as needed.
-  
-  h2. Working with Arrays
-  
-  An ObjectController can accept both arrays and single objects as content.  
-  If the content is an array, the ObjectController will do its best to treat 
-  the array as a single object.  For example, if you set the content of an
-  ObjectController to an array of Contact records and then call:
-  
-    contactController.get('name');
-    
-  The controller will check the name property of each Contact in the array.  
-  If the value of the property for each Contact is the same, that value will 
-  be returned.  If the any values are different, then an array will be 
-  returned with the values from each Contact in them. 
-  
-  Most SproutCore views can work with both arrays and single content, which 
-  means that most of the time, you can simply hook up your views and this will
-  work.
-  
-  If you would prefer to make sure that your ObjectController is always 
-  working with a single object and you are using bindings, you can always 
-  setup your bindings so that they will convert the content to a single object 
-  like so:
-  
-    contentBinding: SC.Binding.Single('MyApp.listController.selection') ;
-
-  This will ensure that your content property is always a single object 
-  instead of an array.
-  
-  @extends SC.Controller
-  @since SproutCore 1.0
-*/
-SC.ObjectController = SC.Controller.extend(
-/** @scope SC.ObjectController.prototype */ {
-
-  // ..........................................................
-  // PROPERTIES
-  // 
-  
-  /**
-    Set to the object you want this controller to manage.  The object should
-    usually be a single value; not an array or enumerable.  If you do supply
-    an array or enumerable with a single item in it, the ObjectController
-    will manage that single item.
-
-    Usually your content object should implement the SC.Observable mixin, but
-    this is not required.  All SC.Object-based objects support SC.Observable
-    
-    @property
-    @type Object
-  */
-  content: null,
-
-  /**
-    If YES, then setting the content to an enumerable or an array with more 
-    than one item will cause the Controller to attempt to treat the array as
-    a single object.  Use of get(), for example, will get every property on
-    the enumerable and return it.  set() will set the property on every item
-    in the enumerable. 
-    
-    If NO, then setting content to an enumerable with multiple items will be
-    treated like setting a null value.  hasContent will be NO.
-    
-    @type Boolean
-  */
-  allowsMultipleContent: NO,
-
-  /**
-    Becomes YES whenever this object is managing content.  Usually this means
-    the content property contains a single object or an array or enumerable
-    with a single item.  Array's or enumerables with multiple items will 
-    normally make this property NO unless allowsMultipleContent is YES.
-    
-    @property
-    @type Boolean
-  */
-  hasContent: function() {
-    return !SC.none(this.get('observableContent'));
-  }.property('observableContent'),
-  
-  /**
-    Makes a controller editable or not editable.  The SC.Controller class 
-    itself does not do anything with this property but subclasses will 
-    respect it when modifying content.
-    
-    @property
-    @type Boolean
-  */
-  isEditable: YES,
-  
-  /**
-    Primarily for internal use.  Normally you should not access this property 
-    directly.  
-    
-    Returns the actual observable object proxied by this controller.  Usually 
-    this property will mirror the content property.  In some cases - notably 
-    when setting content to an enumerable, this may return a different object.
-    
-    Note that if you set the content to an enumerable which itself contains
-    enumerables and allowsMultipleContent is NO, this will become null.
-    
-    @property
-    @type Object
-  */
-  observableContent: function() {
-    var content = this.get('content'),
-        len, allowsMultiple;
-        
-    // if enumerable, extract the first item or possibly become null
-    if (content && content.isEnumerable) {
-      len = content.get('length');
-      allowsMultiple = this.get('allowsMultipleContent');
-      
-      if (len === 1) content = content.firstObject();
-      else if (len===0 || !allowsMultiple) content = null;
-      
-      // if we got some new content, it better not be enum also...
-      if (content && !allowsMultiple && content.isEnumerable) content=null;
-    }
-    
-    return content;
-  }.property('content', 'allowsMultipleContent').cacheable(),
-
-  // ..........................................................
-  // METHODS
-  // 
-
-  /**
-    Override this method to destroy the selected object.
-    
-    The default just passes this call onto the content object if it supports
-    it, and then sets the content to null.  
-    
-    Unlike most calls to destroy() this will not actually destroy the 
-    controller itself; only the the content.  You continue to use the 
-    controller by setting the content to a new value.
-    
-    @returns {SC.ObjectController} receiver
-  */
-  destroy: function() {
-    var content = this.get('observableContent') ;
-    if (content && SC.typeOf(content.destroy) === SC.T_FUNCTION) {
-      content.destroy();
-    } 
-    this.set('content', null) ;  
-    return this;
-  },
-  
-  /**
-    Invoked whenever any property on the content object changes.  
-
-    The default implementation will simply notify any observers that the 
-    property has changed.  You can override this method if you need to do 
-    some custom work when the content property changes.
-    
-    If you have set the content property to an enumerable with multiple 
-    objects and you set allowsMultipleContent to YES, this method will be 
-    called anytime any property in the set changes.
-
-    If all properties have changed on the content or if the content itself 
-    has changed, this method will be called with a key of "*".
-    
-    @param {Object} target the content object
-    @param {String} key the property that changes
-    @returns {void}
-  */
-  contentPropertyDidChange: function(target, key) {
-    if (key === '*') this.allPropertiesDidChange();
-    else this.notifyPropertyChange(key);
-  },
-  
-  /** 
-    Called whenver you try to get/set an unknown property.  The default 
-    implementation will pass through to the underlying content object but 
-    you can override this method to do some other kind of processing if 
-    needed.
-  */
-  unknownProperty: function(key,value) {
-    
-    // avoid circular references
-    if (key==='content') {
-      if (value !== undefined) this.content = value;
-      return this.content;
-    }
-    
-    // for all other keys, just pass through to the observable object if 
-    // there is one.  Use getEach() and setEach() on enumerable objects.
-    var content = this.get('observableContent'), loc, cur, isSame;
-    if (content===null || content===undefined) return undefined; // empty
-
-    // getter...
-    if (value === undefined) {
-      if (content.isEnumerable) {
-        value = content.getEach(key);
-
-        // iterate over array to see if all values are the same. if so, then
-        // just return that value
-        loc = value.get('length');
-        if (loc>0) {
-          isSame = YES;
-          cur = value.objectAt(0);
-          while((--loc > 0) && isSame) {
-            if (cur !== value.objectAt(loc)) isSame = NO ;
-          }
-          if (isSame) value = cur;
-        } else value = undefined; // empty array.
-
-      } else value = (content.isObservable) ? content.get(key) : content[key];
-      
-    // setter
-    } else {
-      if (!this.get('isEditable')) {
-        throw "%@.%@ is not editable".fmt(this,key);
-      }
-      
-      if (content.isEnumerable) content.setEach(key, value);
-      else if (content.isObservable) content.set(key, value);
-      else content[key] = value;
-    }
-    
-    return value;
-  },
-  
-  // ...............................
-  // INTERNAL SUPPORT
-  //
-
-  /** @private - setup observer on init if needed. */
-  init: function() {
-    sc_super();
-    if (this.get('observableContent')) this._scoc_contentDidChange();
-  },
-
-  /** 
-    @private
-    
-    Called whenever the observable content property changes.  This will setup
-    observers on the content if needed.
-  */
-  _scoc_contentDidChange: function() {
-    var last = this._scoc_observableContent,
-        cur  = this.get('observableContent'),
-        func = this.contentPropertyDidChange,
-        efunc= this._scoc_enumerableContentDidChange;
-
-    if (last === cur) return this; // nothing to do
-    
-    this._scoc_observableContent = cur; // save old content
-    
-    // stop observing last item -- if enumerable stop observing set
-    if (last) {
-      if (last.isEnumerable) last.removeObserver('[]', this, efunc);
-      else if (last.isObservable) last.removeObserver('*', this, func);
-    }
-    
-    if (cur) {
-      if (cur.isEnumerable) cur.addObserver('[]', this, efunc);
-      else if (cur.isObservable) cur.addObserver('*', this, func);
-    }
-
-    // notify!
-    if ((last && last.isEnumerable) || (cur && cur.isEnumerable)) {
-      this._scoc_enumerableContentDidChange();
-    } else this.contentPropertyDidChange(cur, '*');
-
-  }.observes("observableContent"),
-  
-  /** @private
-    Called when observed enumerable content has changed.  This will teardown
-    and setup observers on the enumerable content items and then calls 
-    contentPropertyDidChange().  This method may be called even if the new
-    'cur' is not enumerable but the last content was enumerable.
-  */
-  _scoc_enumerableContentDidChange: function() {
-    var cur  = this.get('observableContent'),
-        set  = this._scoc_observableContentItems,
-        func = this.contentPropertyDidChange;
-    
-    // stop observing each old item
-    if (set) {
-      set.forEach(function(item) {
-        if (item.isObservable) item.removeObserver('*', this, func);
-      }, this);
-      set.clear();
-    }
-    
-    // start observing new items if needed
-    if (cur && cur.isEnumerable) {
-      if (!set) set = SC.Set.create();
-      cur.forEach(function(item) {
-        if (set.contains(item)) return ; // nothing to do
-        set.add(item);
-        if (item.isObservable) item.addObserver('*', this, func);
-      }, this); 
-    } else set = null;
-    
-    this._scoc_observableContentItems = set; // save for later cleanup
-  
-    // notify
-    this.contentPropertyDidChange(cur, '*');
-    return this ;
-  }
-        
-}) ;

data/frameworks/sproutcore/frameworks/foundation/controllers/tree.js

@@ -1,109 +0,0 @@
-// ========================================================================
-// SproutCore -- JavaScript Application Framework
-// Copyright ©2006-2008, Sprout Systems, Inc. and contributors.
-// Portions copyright ©2008 Apple, Inc.  All rights reserved.
-// ========================================================================
-
-sc_require('controllers/object');
-sc_require('mixins/selection_support');
-sc_require('private/tree_item_observer');
-
-/**
-  @class
-
-  A TreeController manages a tree of model objects that you might want to 
-  display in the UI using a collection view.  For the most part, you should
-  work with a TreeController much like you would an ObjectController, except
-  that the TreeController will also provide an arrangedObjects property that 
-  can be used as the content of a CollectionView.
-  
-  TODO: Document More
-
-  @extends SC.ObejctController
-  @extends SC.SelectionSupport
-  @since SproutCore 1.0
-*/
-SC.TreeController = SC.ObjectController.extend(SC.SelectionSupport,
-/** @scope SC.TreeController.prototype */ {
-
-  // ..........................................................
-  // PROPERTIES
-  // 
-  
-  /**
-    Set to YES if you want the top-level items in the tree to be displayed as
-    group items in the collection view.
-    
-    @property
-    @type Boolean
-  */
-  treeItemIsGrouped: NO,
-  
-  /**
-    If your content support expanding and collapsing of content, then set this
-    property to the name of the key on your model that should be used to 
-    determine the expansion state of the item.  The default is 
-    "treeItemIsExpanded"
-    
-    @property
-    @type String
-  */
-  treeItemIsExpandedKey: "treeItemIsExpanded",
-  
-  /**
-    Set to the name of the property on your content object that holds the 
-    children array for each tree node.  The default is "treeItemChildren".
-    
-    @property 
-    @type String
-  */
-  treeItemChildrenKey: "treeItemChildren",
-  
-  /**
-    Returns an SC.Array object that actually will represent the tree as a 
-    flat array suitable for use by a CollectionView.  Other than binding this
-    property as the content of a CollectionView, you generally should not 
-    use this property directly.  Instead, work on the tree content using the
-    TreeController like you would any other ObjectController.
-  
-    @property
-    @type SC.Array
-  */
-  arrangedObjects: function() {
-    var ret, content = this.get('content');
-    if (content) {
-      ret = SC.TreeItemObserver.create({ item: content, delegate: this });
-    } else ret = null; // empty!
-    this._sctc_arrangedObjects = ret ;
-    
-    return ret ;
-  }.property().cacheable(),
-
-  // ..........................................................
-  // PRIVATE
-  // 
-  
-  /**
-    @private
-    
-    Manually invalidate the arrangedObjects cache so that we can teardown
-    any existing value.  We do it via an observer so that this will fire 
-    immediately instead of waiting on some other component to get 
-    arrangedObjects again.
-  */
-  _sctc_invalidateArrangedObjects: function() {
-    this.propertyWillChange('arrangedObjects');
-    
-    var ret = this._sctc_arrangedObjects;
-    if (ret) ret.destroy();
-    this._sctc_arrangedObjects = null;
-    
-    this.propertyDidChange('arrangedObjects');
-  }.observes('content', 'treeItemIsExpandedKey', 'treeItemChildrenKey', 'treeItemIsGrouped'),
-  
-  _sctc_arrangedObjectsContentDidChange: function() {
-    this.updateSelectionAfterContentChange();
-  }.observes('*arrangedObjects.[]')
-  
-});
-

data/frameworks/sproutcore/frameworks/foundation/core.js

@@ -1,136 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
-//            Portions ©2008-2009 Apple, Inc. All rights reserved.
-// License:   Licened under MIT license (see license.js)
-// ==========================================================================
-
-/**
-  Indicates that the collection view expects to accept a drop ON the specified
-  item.
-*/
-SC.DROP_ON = 0x01 ;
-
-/**
-  Indicates that the collection view expects to accept a drop BEFORE the 
-  specified item.
-*/
-SC.DROP_BEFORE = 0x02 ;
-
-/**
-  Indicates that the collection view expects to accept a drop AFTER the
-  specified item.  This is treated just like SC.DROP_BEFORE is most views
-  except for tree lists.
-*/
-SC.DROP_AFTER = 0x04 ;
-
-/**
-  Indicates that the collection view want's to know which operations would 
-  be allowed for either drop operation.
-*/
-SC.DROP_ANY = 0x07 ;
-
-SC.mixin(/** @scope SC */ {
-  
-  /**
-    Reads or writes data from a global cache.  You can use this facility to
-    store information about an object without actually adding properties to
-    the object itself.  This is needed especially when working with DOM,
-    which can leak easily in IE.
-    
-    To read data, simply pass in the reference element (used as a key) and
-    the name of the value to read.  To write, also include the data.
-    
-    You can also just pass an object to retrieve the entire cache.
-    
-    @param elem {Object} An object or Element to use as scope
-    @param name {String} Optional name of the value to read/write
-    @param data {Object} Optional data.  If passed, write.
-    @returns {Object} the value of the named data
-  */
-  data: function(elem, name, data) {
-    elem = (elem === window) ? "@window" : elem ;
-    var hash = SC.hashFor(elem) ; // get the hash key
-    
-    // Generate the data cache if needed
-    var cache = SC._data_cache ;
-    if (!cache) SC._data_cache = cache = {} ;
-    
-    // Now get cache for element
-    var elemCache = cache[hash] ;
-    if (name && !elemCache) cache[hash] = elemCache = {} ;
-    
-    // Write data if provided 
-    if (elemCache && (data !== undefined)) elemCache[name] = data ;
-    
-    return (name) ? elemCache[name] : elemCache ;
-  },
-  
-  /**
-    Removes data from the global cache.  This is used throughout the
-    framework to hold data without creating memory leaks.
-    
-    You can remove either a single item on the cache or all of the cached 
-    data for an object.
-    
-    @param elem {Object} An object or Element to use as scope
-    @param name {String} optional name to remove. 
-    @returns {Object} the value or cache that was removed
-  */
-  removeData: function(elem, name) {
-    elem = (elem === window) ? "@window" : elem ;
-    var hash = SC.hashFor(elem) ;
-    
-    // return undefined if no cache is defined
-    var cache = SC._data_cache ;
-    if (!cache) return undefined ;
-    
-    // return undefined if the elem cache is undefined
-    var elemCache = cache[hash] ;
-    if (!elemCache) return undefined;
-    
-    // get the return value
-    var ret = (name) ? elemCache[name] : elemCache ;
-    
-    // and delete as appropriate
-    if (name) {
-      delete elemCache[name] ;
-    } else {
-      delete cache[hash] ;
-    }
-    
-    return ret ;
-  }
-}) ;
-
-SC.mixin(Function.prototype, {
-  /**
-    Creates a timer that will execute the function after a specified 
-    period of time.
-    
-    If you pass an optional set of arguments, the arguments will be passed
-    to the function as well.  Otherwise the function should have the 
-    signature:
-    
-    {{{
-      function functionName(timer)
-    }}}
-
-    @param target {Object} optional target object to use as this
-    @param interval {Number} the time to wait, in msec
-    @returns {SC.Timer} scheduled timer
-  */
-  invokeLater: function(target, interval) {
-    if (interval === undefined) interval = 1 ;
-    var f = this;
-    if (arguments.length > 2) {
-      var args = SC.$A(arguments).slice(2,arguments.length);
-      args.unshift(target);
-      // f = f.bind.apply(f, args) ;
-      var that = this, func = f ;
-      f = function() { return func.apply(that, args.slice(1)); } ;
-    }
-    return SC.Timer.schedule({ target: target, action: f, interval: interval });
-  }    
-
-});