sproutcore 1.0.1049.pre.2 → 1.4.0.rc

data/lib/frameworks/sproutcore/frameworks/foundation/mixins/flowed_layout.js

@@ -1,415 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
-//            Portions ©2008-2009 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-SC.ALIGN_JUSTIFY = "justify";
-/**
-  @namespace 
-
-  Normal SproutCore views are absolutely positioned--parent views have relatively
-  little input on where their child views are placed.
-  
-  This mixin makes a view layout its child views itself, flowing left-to-right
-  or up-to-down, and, optionally, wrapping.
-  
-  Child views with useAbsoluteLayout===YES will be ignored in the layout process.
-  This mixin detects when child views have changed their size, and will adjust accordingly.
-  It also observes child views' isVisible and calculatedWidth/Height properties.
-  If flowSize is implemented but specifies widthPercent and heightPercent, the width and height
-  will be calculated based on padding-adjusted size; values not specified in flowSize will always
-  be taken from the flowed view's frame (calculatedWidth/Height ignored).
-  
-  This view mixes very well with animation. Further, it is able to automatically mix
-  in to child views it manages, created or not yet created, allowing you to specify
-  settings such as animation once only, and have everything "just work".
-  
-  Like normal views, you simply specify child views--everything will "just work."
-  
-  @since SproutCore 1.0
-*/
-SC.FlowedLayout = {
-  /**
-    The direction of flow.
-  */
-  layoutDirection: SC.LAYOUT_HORIZONTAL,
-
-  /**
-    Whether the view should automatically resize (to allow scrolling, for instance)
-  */
-  autoResize: YES,
-  
-  /**
-    The alignment of items within rows or columns.
-  */
-  align: SC.ALIGN_LEFT,
-  
-  /**
-    If YES, flowing child views are allowed to wrap to new rows or columns.
-  */
-  canWrap: YES,
-  
-  /**
-    A set of spacings (left, top, right, bottom) for subviews. Defaults to 0s all around.
-    This is the amount of space that will be before, after, above, and below the view. These
-    spacings do not collapse into each other.
-    
-    You can also set flowSpacing on any child view, or implement flowSpacingForView.
-  */
-  defaultFlowSpacing: { left: 0, bottom: 0, top: 0, right: 0 },
-  
-  /**
-    Padding around the edges of this flow layout view.
-  */
-  flowPadding: { left: 0, bottom: 0, right: 0, top: 0 },
-  
-  
-  concatenatedProperties: ["childMixins"],
-  
-  initMixin: function() {
-    this._scfl_tile();
-  },
-  
-  /**
-    Detects when the child views change.
-  */
-  _scfl_childViewsDidChange: function(c) {
-    this.invokeOnce("_scfl_tile");
-  }.observes("childViews"),
-  
-  _scfl_layoutPropertyDidChange: function(){
-    this.invokeOnce("_scfl_tile");
-  },
-  
-  /**
-    This function is OURs. Also, we are not yet efficient. We could update only
-    views after a certain view, sometime in future.
-  */
-  layoutChildViews: function() {
-    this.invokeOnce("_scfl_tile");
-  },
-  
-  /**
-    Overriden to only update if it is a view we do not manage, or the width or height has changed
-    since our last record of it.
-  */
-  layoutDidChangeFor: function(c) {
-    if (c.get("useAbsoluteLayout")) return sc_super();
-    if (!this._scfl_itemLayouts) return sc_super();
-    
-    var l = this._scfl_itemLayouts[SC.guidFor(c)];
-    if (!l) return sc_super();
-    if (c.layout.width !== l.width || c.layout.height !== l.height) return sc_super();
-  },
-  
-  /**
-    @private
-    Sets up observers on child view. We observe three things:
-    - isVisible
-    - calculatedWidth
-    - calculatedHeight
-  */
-  _scfl_observeChild: function(c) {
-    if (c._scfl_isBeingObserved) return;
-    c._scfl_isBeingObserved = YES;
-    c.addObserver('isVisible', this, '_scfl_layoutPropertyDidChange');
-    c.addObserver('calculatedWidth', this, '_scfl_layoutPropertyDidChange');
-    c.addObserver('calculatedHeight', this, '_scfl_layoutPropertyDidChange');
-  },
-  
-  /**
-    @private
-    Removes observers on child view.
-  */
-  _scfl_unobserveChild: function(c) {
-    c._scfl_isBeingObserved = NO;
-    c.removeObserver('isVisible', this, '_scfl_layoutPropertyDidChange');
-    c.removeObserver('calculatedWidth', this, '_scfl_layoutPropertyDidChange');
-    c.removeObserver('calculatedHeight', this, '_scfl_layoutPropertyDidChange');
-  },
-  
-  /**
-    Returns the flow spacings for a given view. By default, returns the view's flowSpacing,
-    and if they don't exist, the defaultFlowSpacing for this view.
-  */
-  flowSpacingForView: function(idx, view) {
-    if (view.get("isSpacer")) return {left:0,top:0,right:0,bottom:0};
-    var fm = view.get("flowSpacing");
-    if (!SC.none(fm)) return fm;
-    return this.get("defaultFlowSpacing");
-  },
-  
-  /**
-    Returns the flow size for a given view. The default version checks the view's flowSize,
-    then calculatedWidth/Height, then frame.
-    
-    This should return a structure like: { width: whatever, height: whatever }
-  */
-  flowSizeForView: function(idx, view) {
-    // first try flowSize
-    var fs = SC.clone(view.get("flowSize"));
-    if (!SC.none(fs)) {
-      // if we have a flow size, adjust for a) width/heightPercentage and b) missing params.
-      var frame = this.get("frame"), padding = this.get("flowPadding"), spacing = this.flowSpacingForView(idx, view);
-      
-      // you can't set it w/percentage for the expand direction
-      var expandsHorizontal = (this.get("layoutDirection") === SC.LAYOUT_HORIZONTAL && !this.get("canWrap")) ||
-        (this.get("layoutDirection") === SC.LAYOUT_VERTICAL && this.get("canWrap"));
-      
-      if (!SC.none(fs.widthPercentage) && !expandsHorizontal) {
-        fs.width = (frame.width - padding.left - padding.right) * fs.widthPercentage - spacing.left - spacing.right;
-      }
-      if (!SC.none(fs.heightPercentage) && expandsHorizontal) {
-        fs.height = (frame.height - padding.top - padding.bottom) * fs.heightPercentage - spacing.top - spacing.bottom;
-      }
-      if (SC.none(fs.width)) fs.width = view.get("frame").width;
-      if (SC.none(fs.height)) fs.height = view.get("frame").height;
-      
-      return fs;
-    }
-    
-    // then calculated size
-    var cw = view.get("calculatedWidth"), ch = view.get("calculatedHeight");
-    if (!SC.none(cw) && !SC.none(ch)) return { width: cw, height: ch };
-    
-    // finally, use frame
-    var f = view.get("frame");
-    return { width: f.width, height: f.height };
-  },
-  
-  /**
-    Takes a row and positions everything within the row, calling updateLayout.
-    It should return the row height.
-  */
-  flowRow: function(row, rowSpace, padding, rowOffset, rowSize, primary, secondary, align) {
-    rowOffset += padding[secondary];
-    
-    // if it is justified, we'll add padding between ALL views.
-    var item, len = row.length, idx, layout, rowLength = 0, totalSpaceUnits = 0, spacePerUnit = 0;
-    
-    // first, determine the width of all items, and find out how many virtual spacers there are
-    for (idx = 0; idx < len; idx++) {
-      item = row[idx];
-      if (item.get("isSpacer")) totalSpaceUnits += item.get("spaceUnits") || 1;
-      rowLength += item._scfl_cachedSpacedSize[primary === "left" ? "width" : "height"];
-    }
-    
-    // add space units for justification
-    if (len > 1 && align === SC.ALIGN_JUSTIFY) {
-      totalSpaceUnits += len - 1;
-    }
-    
-    // calculate space per unit if needed
-    if (totalSpaceUnits > 0) {
-      spacePerUnit = (rowSpace - rowLength) / totalSpaceUnits;
-      rowLength = rowSpace;
-    }
-    
-    // prepare
-    var x, y, itemOffset = 0;
-    
-    // handle align
-    if (align === SC.ALIGN_RIGHT || align === SC.ALIGN_BOTTOM) itemOffset = (rowSpace - rowLength);
-    else if (align === SC.ALIGN_CENTER || align === SC.ALIGN_MIDDLE) itemOffset = (rowSpace - rowLength) / 2;
-    
-    // position
-    for (idx = 0; idx < len; idx++) {
-      item = row[idx];
-      
-      // now update flow position
-      if (primary == "left") {
-        x = itemOffset + padding.left;
-        y = rowOffset + padding.top;
-      } else {
-        x = rowOffset + padding.left;
-        y = itemOffset + padding.top;
-      }
-      
-      // handle auto size
-      if (item.get("fillHeight") && secondary === "top") item._scfl_cachedFlowSize["height"] = rowSize;
-      if (item.get("fillWidth") && secondary === "left") item._scfl_cachedFlowSize["width"] = rowSize;
-      
-      // update offset
-      if (item.get("isSpacer")) {
-        // the cached size is the minimum size for the spacer
-        var spacerSize = item._scfl_cachedSpacedSize[primary === "left" ? "width" : "height"];
-        
-        // get the spacer size
-        spacerSize = Math.max(spacerSize, spacePerUnit * (item.get("spaceUnits") || 1));
-        
-        // add to item offset
-        itemOffset += spacerSize;
-        
-        // and finally, set back the cached flow size value--
-        // not including spacing (this is the view size for rendering)
-        item._scfl_cachedFlowSize[primary === "left" ? "width" : "height"] = spacerSize;
-        item._scfl_cachedFlowSize[secondary === "left" ? "width" : "height"] = rowSize;
-      } else {
-        itemOffset += item._scfl_cachedSpacedSize[primary === "left" ? "width" : "height"];
-      }
-      
-      this.flowPositionView(idx, item, x, y);
-      
-      // update justification
-      if (align === SC.ALIGN_JUSTIFY) itemOffset += spacePerUnit;
-    }
-  },
-  
-  flowPositionView: function(idx, item, x, y) {
-    var spacing = item._scfl_cachedFlowSpacing, size = item._scfl_cachedFlowSize;
-    var last = this._scfl_itemLayouts[SC.guidFor(item)];
-    
-    var l = {
-      left: x + spacing.left,
-      top: y + spacing.top,
-      width: size.width,
-      height: size.height
-    };
-    
-    // we must set this first, or it will think it has to update layout again, and again, and again
-    // and we get a crash.
-    this._scfl_itemLayouts[SC.guidFor(item)] = l;
-    
-    // Also, never set if the same. We only want to compare layout properties, though
-    if (last && 
-      last.left == l.left && last.top == l.top && 
-      last.width == l.width && last.height == l.height
-    ) {
-      return;
-    }
-
-    item.set("layout", l);
-    item.updateLayout();
-  },
-  
-  _scfl_tile: function() {
-    if (!this._scfl_itemLayouts) this._scfl_itemLayouts = {};
-    
-    var isObserving = this._scfl_isObserving || {},
-        nowObserving = {};
-    
-    var children = this.get("childViews"), child, idx, len = children.length,
-        rows = [], row = [], rowSize = 0, 
-        rowOffset = 0, 
-        itemOffset = 0, 
-        width = this.get('frame').width,
-        height = this.get('frame').height,
-        canWrap = this.get("canWrap"),
-        layoutDirection = this.get("layoutDirection"),
-        padding = this.get("flowPadding"),
-        childSize, childSpacing, align = this.get("align");
-    
-    var primary, primary_os, primary_d, secondary, secondary_os, secondary_d, primaryContainerSize;
-    if (layoutDirection === SC.LAYOUT_HORIZONTAL) {
-      primaryContainerSize = width - padding["right"] - padding["left"];
-      primary = "left"; secondary = "top";
-      primary_os = "right"; secondary_os = "bottom";
-      primary_d = "width"; secondary_d = "height";
-    } else {
-      primaryContainerSize = height - padding["bottom"] - padding["top"];
-      primary = "top"; secondary = "left";
-      primary_os = "bottom"; secondary_os = "right";
-      primary_d = "height"; secondary_d = "width";
-    }
-    
-    // now, loop through all child views and group them into rows.
-    // note that we are NOT positioning.
-    // when we are done with a row, we call flowRow to finish it.
-    for (idx = 0; idx < len; idx++) {
-      // get a child.
-      child = children[idx];
-      if (child.get("useAbsoluteLayout")) continue;
-      
-      // update observing lists
-      delete isObserving[SC.guidFor(child)];
-      nowObserving[SC.guidFor(child)] = child;
-      
-      // skip positioning of items with isVisible===false
-      if (!child.get("isVisible")) continue;
-      
-      // get spacing, size, and cache
-      childSize = this.flowSizeForView(idx, child);
-      
-      // adjust for spacer
-      if (child.get("isSpacer")) {
-        childSize[primary_d] = 0;
-      }
-      
-      child._scfl_cachedFlowSize = { width: childSize.width, height: childSize.height }; // supply a clone, since we are about to modify
-      
-      childSpacing = this.flowSpacingForView(idx, child);
-      childSize.width += childSpacing.left + childSpacing.right;
-      childSize.height += childSpacing.top + childSpacing.bottom;
-      
-      // flowRow will use this
-      child._scfl_cachedFlowSpacing = childSpacing;
-      child._scfl_cachedSpacedSize = childSize;
-      
-      // determine if the item can fit in the row
-      if (canWrap && row.length > 0) {
-        // test, including the collapsed right margin+padding
-        if (itemOffset + childSize[primary_d] >= primaryContainerSize) {
-          // first, flow this row
-          this.flowRow(row, primaryContainerSize, padding, rowOffset, rowSize, primary, secondary, align);
-          
-          // We need another row.
-          row = [];
-          rows.push(row);
-          rowOffset += rowSize;
-          rowSize = 0;
-          itemOffset = 0;
-        }
-      }
-      
-      // add too row and update row size+item offset
-      row.push(child);
-      rowSize = Math.max(childSize[secondary_d], rowSize);
-      itemOffset += childSize[primary_d]; 
-    }
-    
-    // flow last row
-    this.flowRow(row, primaryContainerSize, padding, rowOffset, rowSize, primary, secondary, align);
-
-    
-    // update calculated width/height
-    this._scfl_lastFrameSize = this.get("frame");
-    if (!canWrap && this.get("autoResize")) {
-      this._scfl_lastFrameSize[primary_d] = itemOffset + padding[primary] + padding[primary_os];
-      this.adjust(primary_d, itemOffset + padding[primary] + padding[primary_os]);
-    } else if (this.get("autoResize")) {
-      this._scfl_lastFrameSize[secondary_d] = rowOffset + rowSize + padding[secondary] + padding[secondary_os];
-      this.adjust(secondary_d, rowOffset + rowSize + padding[secondary] + padding[secondary_os]);
-    }
-    
-    
-    // cleanup on aisle 7
-    for (idx in isObserving) {
-      this._scfl_unobserveChild(isObserving[idx]);
-    }
-
-    for (idx in nowObserving) {
-      this._scfl_observeChild(nowObserving[idx]);
-    }
-    
-    this._scfl_isObserving = nowObserving;
-  },
-  
-  _scfl_frameDidChange: function() {
-    var frame = this.get("frame"), lf = this._scfl_lastFrameSize;
-    this._scfl_lastFrameSize = frame;
-
-    if (lf && lf.width == frame.width && lf.height == frame.height) return;
-    
-    this.invokeOnce("_scfl_tile");
-  }.observes("frame"),
-  
-  destroyMixin: function() {
-    var isObserving = this._scfl_isObserving || SC.CoreSet.create();
-    for (var idx in isObserving) {
-      this._scfl_unobserveChild(isObserving[idx]);
-    }
-  }
-  
-};

data/lib/frameworks/sproutcore/frameworks/foundation/mixins/gestureable.js

@@ -1,106 +0,0 @@
-// ==========================================================================
-// Project:   SproutCore - JavaScript Application Framework
-// Copyright: ©2006-2009 Sprout Systems, Inc. and contributors.
-//            Portions ©2008-2010 Apple Inc. All rights reserved.
-// License:   Licensed under MIT license (see license.js)
-// ==========================================================================
-
-SC.Gesturable = {
-  concatenatedProperties: ["gestures"],
-  gestures: [],
-  
-  initMixin: function() {
-    this.createGestures();
-  },
-  
-  createGestures: function() {
-    var gestures = this.get("gestures"), idx, len = gestures.length, g, _g = [];
-
-    // loop through all gestures
-    for (idx = 0; idx < len; idx++) {
-      // get the proper gesture
-      if (SC.typeOf(gestures[idx]) === SC.T_STRING) {
-        g = this.get(gestures[idx]);
-      } else {
-        g = gestures[idx];
-      }
-      
-      // if it was not found, well, that's an error.
-      if (!g) {
-        throw "Could not find gesture named '" + gestures[idx] + "' on view.";
-      }
-      
-      // if it is a class, instantiate (it really ought to be a class...)
-      if (g.isClass) {
-        g = g.create({
-          view: this
-        });
-      }
-      
-      // and set the gesture instance and add it to the array.
-      if (SC.typeOf(gestures[idx]) === SC.T_STRING) this[gestures[idx]] = g;
-      _g.push(g);
-    }
-    
-    this.set("gestures", _g);
-  },
-  
-  /**
-    Handles touch start. By default, merely passes it to gestureTouchStart.
-    If you override, pass any touch you don't want to take to gestureTouchStart yourself.
-    
-    After letting gestureTouchStart handle a touch, you can check the "isInteresting" property
-    of the touch to see if any gesture is interested.
-    
-    Usually, even if no gesture is interested (yet), you'll not want to release the touch just yet.
-  */
-  touchStart: function(touch) {
-    this.gestureTouchStart(touch);
-  },
-  
-  /**
-    Handles touch drags, similarly to touch starts.
-  */
-  touchesDragged: function(evt, touches) {
-    this.gestureTouchesDragged(evt, touches);
-  },
-  
-  /**
-    Passes touchEnd along to gestureTouchEnd.
-  */
-  touchEnd: function(touch) {
-    this.gestureTouchEnd(touch);
-  },
-  
-  /**
-    Passes the touch to the gestures to 
-  */
-  gestureTouchStart: function(touch) {
-    touch.isInteresting = 0;
-    
-    var gestures = this.get("gestures"), idx, len = gestures.length, g;
-    for (idx = 0; idx < len; idx++) {
-      g = gestures[idx];
-      g.unassignedTouchDidStart(touch);
-    }
-  },
-  
-  /**
-    Loops over touches and passes them to the gestures.
-  */
-  gestureTouchesDragged: function(evt, touches) {
-    var gestures = this.get("gestures"), idx, len = gestures.length, g;
-    for (idx = 0; idx < len; idx++) {
-      g = gestures[idx];
-      g.unassignedTouchesDidChange(evt, touches);
-    }
-  },
-  
-  gestureTouchEnd: function(touch) {
-    var gestures = this.get("gestures"), idx, len = gestures.length, g;
-    for (idx = 0; idx < len; idx++) {
-      g = gestures[idx];
-      g.unassignedTouchDidEnd(touch);
-    }
-  }
-};