sproutit-sproutcore 1.0.203 → 1.0.20090721145236

data/frameworks/sproutcore/frameworks/foundation/mixins/tree_item_content.js

@@ -1,159 +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)
-// ==========================================================================
-
-/**
-  @namespace
-
-  A tree item is a model object that acts as a node in a tree-like data 
-  structure such as a hierarchy of folders or outline of items.  This mixin 
-  can be applied to tree item model objects to customize the way the tree
-  information is extracted from the object.
-
-  h2. Basic Implementation
-  
-  If you add this mixin, you must implement the treeItemChildren property so
-  that it returns the current array of child tree items for the receiver.  If
-  you do not implement this property the tree item will not function.
-  
-  h2. Optimizing Branches
-  
-  The most common use of this mixin is to override the treeItemBranchIndexes
-  property to return an index set of child items that are themselves branches
-  in the tree.  Normally the TreeController will need to walk every item in
-  your list to determine these branch items.  However by implementing this 
-  method yourself, you can provide a result faster.
-  
-  If none of your child items are branches, override this property to return
-  null or an empty index set.
-  
-  @since SproutCore 1.0
-*/
-SC.TreeItemContent = {
-
-  /** Walk like a duck. */
-  isTreeItemContent: YES,
-  
-  /**
-    Property returns the children for this tree item.  The default simply 
-    returns null.  If you implement this mixin, you MUST implement this 
-    property to return the actual tree item children for the item.
-   
-    @property
-    @type {SC.Array}
-  */
-  treeItemChildren: null,
-
-  /**
-    The default property used to determine if the tree item is expanded.  You
-    can implement you model object to update this property or you can override
-    treeItemDisclosureState() to compute the disclosure state however you 
-    want.
-    
-    @property 
-    @type {Boolean}
-  */
-  treeItemIsExpanded: YES,
-  
-  /**
-    Indicates whether the tree item should be rendered as a group or not. 
-    This property is only useful on the root item in your tree.  Setting it to
-    YES on any other item will be ignored.
-    
-    @property
-    @type {Boolean}
-  */
-  treeItemIsGrouped: NO,
-  
-  /**
-    Returns the disclosure state for the tree item, which appears at the 
-    index of the parent's treeItemChildren array.  The response must be one of 
-    SC.BRANCH_OPEN, SC.BRANCH_CLOSED or SC.LEAF_NODE.
-     
-    If the parent parameter is null, then this item is part of the root 
-    children array.
-    
-    This method will only be called for tree items that have children.  Tree
-    items with no children are assumed to be leaf nodes.
-
-    The default implementation uses the treeItemIsExpanded property to 
-    determine if the item should be open or closed.
-    
-    @param {Object} parent the parent item containing this item
-    @param {Number} idx the index of the item in the parent
-    @returns {Number} branch state
-  */
-  treeItemDisclosureState: function(parent, idx) {
-    return this.get('treeItemIsExpanded') ? SC.BRANCH_OPEN : SC.BRANCH_CLOSED;
-  },
-  
-  /**
-    Collapse the tree item.  The default implementation will change the 
-    treeItemIsExpanded property, but you can override this method to handle
-    collapsing anyway you like.
-    
-    @param {Object} parent the parent item containing this item
-    @param {Number} idx the index of the item in the parent
-    @returns {void}
-  */
-  treeItemCollapse: function(parent, idx) {
-    this.setIfChanged('treeItemIsExpanded', NO);    
-  },
-
-  /**
-    Expand the tree item.  The default implementation will change the 
-    treeItemIsExpanded property, but you can override this method to handle
-    collapsing anyway you like.
-    
-    @param {Object} parent the parent item containing this item
-    @param {Number} idx the index of the item in the parent
-    @returns {void}
-  */
-  treeItemExpand: function(parent, idx) {
-    this.setIfChanged('treeItemIsExpanded', YES);    
-  },
-  
-  /**
-    Returns an index set containing the child indexes of the item that are 
-    themselves branches.  This will only be called on tree items with a branch
-    disclosure state.
-
-    If the passed parent and index are both null, then the receiver is the 
-    root node in the tree.
-    
-    The default implementation iterates over the item's children to get the
-    disclosure state of each one.  Child items with a branch disclosure state
-    will have their index added to the return index set.  
-    
-    You may want to override this method to provide a more efficient 
-    implementation if you are working with large data sets and can infer which
-    children are branches without iterating over each one.
-
-    If you know for sure that all of the child items for this item are leaf
-    nodes and not branches, simply override this method to return null.
-    
-    @param {Object} parent the parent item containing this item
-    @param {Number} index the index of the item in the parent
-    @param {SC.IndexSet} branch indexes
-  */
-  treeItemBranchIndexes: function(parent, index) {
-    var children = this.get('treeItemChildren'),
-        ret, lim, idx, item;
-        
-    if (!children) return null ; // nothing to do
-    
-    ret = SC.IndexSet.create();
-    lim = children.get('length');
-    for(idx=0;idx<lim;idx++) {
-      if (!(item = children.objectAt(idx))) continue;
-      if (!item.get('treeItemChildren')) continue;
-      if (item.treeItemDisclosureState(this,idx)!==SC.LEAF_NODE) ret.add(idx);
-    }
-
-    return ret.get('length')>0 ? ret : null;
-  }
-  
-};

data/frameworks/sproutcore/frameworks/foundation/mixins/validatable.js

@@ -1,176 +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)
-// ==========================================================================
-
-/**
-  @namespace
-
-  Views that include the Validatable mixin can be used with validators to 
-  ensure their values are valid.  
-  
-*/
-SC.Validatable = {
-  
-  initMixin: function() {
-    this._validatable_validatorDidChange() ;
-  },
-  
-  /**
-    The validator for this field.  
-  
-    Set to a validator class or instance.  If this points to a class, it will 
-    be instantiated when the validator is first used.
-  */
-  validator: null,
-
-  /**
-    This property must return the human readable name you want used when 
-    describing an error condition.  For example, if set this property to
-    "Your Email", then the returned error string might be something like
-    "Your Email is not valid".
-    
-    You can return a loc string here if you like.  It will be localized when
-    it is placed into the error string.
-  */
-  errorLabel: null,
-
-  /**
-    YES if the receiver is currently valid.
-    
-    This property watches the value property by default.  You can override
-    this property if you want to use some other method to calculate the
-    current valid state.
-    
-    @field
-  */
-  isValid: function() { 
-    return SC.typeOf(this.get('value')) !== SC.T_ERROR; 
-  }.property('value'),
-  
-  /**
-    The form that the view belongs to.  May be null if the view does not 
-    belong to a form.  This property is usually set automatically by an 
-    owner form view.
-  */
-  ownerForm: null,
-  
-  /**
-    Attempts to validate the receiver. 
-    
-    Runs the validator and returns SC.VALIDATE_OK, SC.VALIDATE_NO_CHANGE,
-    or an error object.  If no validator is installed, this method will
-    always return SC.VALIDATE_OK.
-
-    @param {Boolean} partialChange YES if this is a partial edit.
-    @returns SC.VALIDATE_OK, error, or SC.VALIDATE_NO_CHANGE
-  */
-  performValidate: function(partialChange) {
-    var ret = SC.VALIDATE_OK ;
-
-    if (this._validator) {
-      var form = this.get('ownerForm') ;
-      if (partialChange) {
-        ret = this._validator.validatePartial(form,this) ;
-
-        // if the partial returned NO_CHANGE, then check to see if the 
-        // field is valid anyway.  If it is not valid, then don't update the
-        // value.  This way the user can have partially constructed values 
-        // without the validator trying to convert it to an object.
-        if ((ret == SC.VALIDATE_NO_CHANGE) && (this._validator.validateChange(form, this) == SC.VALIDATE_OK)) {
-          ret = SC.VALIDATE_OK; 
-        }
-      } else ret = this._validator.validateChange(form, this) ;
-    }
-    return ret ;
-  },
-
-  /**
-    Runs validateSubmit.  You should use this in your implementation of 
-    validateSubmit.  If no validator is installed, this always returns
-    SC.VALIDATE_OK
-  */
-  performValidateSubmit: function() {
-    return this._validator ? this._validator.validateSubmit(this.get('ownerForm'), this) : SC.VALIDATE_OK;
-  },
-  
-  /**
-    Runs a keypress validation.  Returns YES if the keypress should be 
-    allowed, NO otherwise.  If no validator is defined, always returns YES.
-    
-    @param {String} charStr the key string
-    @returns {Boolean}
-  */
-  performValidateKeyDown: function(evt) {
-    // ignore anything with ctrl or meta key press
-    var charStr = evt.getCharString();
-    if (!charStr) return YES ;
-    return this._validator ? this._validator.validateKeyDown(this.get('ownerForm'), this, charStr) : YES;
-  },
-  
-  /**
-    Returns the validator object, if one has been created.
-    
-    @property {SC.Validator} the object
-  */
-  validatorObject: function() {
-    return this._validator;
-  }.property(),
-  
-  /**
-    Invoked by the owner form just before submission.  Override with your 
-    own method to commit any final changes after you perform validation. 
-    
-    The default implementation simply calls performValidateSubmit() and 
-    returns that value.
-  */
-  validateSubmit: function() { return this.performValidateSubmit(); },
-  
-  /**
-    Convert the field value string into an object.
-    
-    This method will call the validators objectForFieldValue if it exists.
-    
-    @param fieldValue the raw value from the field.
-    @returns converted object
-  */
-  objectForFieldValue: function(fieldValue, partialChange) {
-    return this._validator ? this._validator.objectForFieldValue(fieldValue, this.get('ownerForm'), this) : fieldValue ;
-  },
-  
-  /**
-    Convert the object into a field value.
-    
-    This method will call the validator's fieldValueForObject if it exists.
-    
-    @param object the objec to convert
-    @returns converted field value
-  */
-  fieldValueForObject: function(object) {
-    return this._validator ? this._validator.fieldValueForObject(object, this.get('ownerForm'), this) : object ;
-  },
-  
-  _validatable_displayObserver: function() {
-    this.displayDidChange();
-  }.observes('isValid'),
-  
-  updateLayerMixin: function(context) {
-    context.setClass('invalid', !this.get('isValid'));
-  },
-  
-  // invoked whenever the attached validator changes.
-  _validatable_validatorDidChange: function() {
-    var form = this.get('ownerForm') ;
-    var val = SC.Validator.findFor(form, this, this.get('validator')) ;
-    if (val != this._validator) {
-      this.propertyWillChange('validatorObject');
-      if (this._validator) this._validator.detachFrom(form, this) ;
-      this._validator = val;
-      if (this._validator) this._validator.attachTo(form, this) ;
-      this.propertyDidChange('validatorObject');
-    }  
-  }.observes('validator', 'ownerForm')
-      
-};

data/frameworks/sproutcore/frameworks/foundation/panes/main.js

@@ -1,47 +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('panes/pane');
-
-/** @class
-
-  Most SproutCore applications have a main pane, which dominates the 
-  application page.  You can extend from this view to implement your own main 
-  pane.  This class will automatically make itself main whenever you append it 
-  to a document, removing any other main pane that might be currently in 
-  place.  If you do have another already focused as the keyPane, this view 
-  will also make itself key automatically.  The default way to use the main 
-  pane is to simply add it to your page like this:
-  
-  {{{
-    SC.MainPane.create().append();
-  }}}
-  
-  This will cause your root view to display.  The default layout for a 
-  MainPane is to cover the entire document window and to resize with the 
-  window.
-
-  @extends SC.Pane
-  @since SproutCore 1.0
-*/
-SC.MainPane = SC.Pane.extend({
-
-  layout: { left:0, right:0, top:0, bottom:0 },
-  
-  /** @private - extends SC.Pane's method */
-  paneDidAttach: function() {
-    var ret = sc_super();
-    var responder = this.rootResponder;
-    responder.makeMainPane(this);
-    if (!responder.get('keyRootView')) responder.makeKeyPane(this);
-    return ret ;
-  },
-  
-  acceptsKeyPane: YES,
-  
-  classNames: ['sc-main']
-});