sproutcore 1.6.0.beta.2-x86-mingw32

data/lib/frameworks/sproutcore/frameworks/desktop/views/split_divider.js

@@ -0,0 +1,58 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+
+/**
+  @class
+
+  A SplitDividerView displays a divider between two views within a SplitView.
+  Clicking and dragging the divider will change the thickness of each view
+  either to the top/left or bottom/right of the divider.
+
+  Double-clicking on the SplitDividerView will try to collapse the first
+  view within the SplitView that has property canCollapse set to true,
+  so it is not visible, unless you have canCollapse disabled on the SplitView.
+
+  This view must be a direct child of the split view it works with. It must
+  be surrounded by two other views.
+
+  @extends SC.View
+  @author Charles Jolley
+  @author Lawrence Pit
+  @author Erich Ocean
+  @test in split
+*/
+SC.SplitDividerView = SC.View.extend(
+/** @scope SC.SplitDividerView.prototype */ {
+
+  /**
+    @type Array
+    @default ['sc-split-divider-view']
+    @see SC.View#classNames
+  */
+  classNames: ['sc-split-divider-view'],
+  
+  /** @private */
+
+  /** @private */
+  mouseDown: function(evt) {
+    var splitView = this.get('splitView');
+    return (splitView) ? splitView.mouseDownInThumbView(evt, this) : sc_super();
+  },
+  
+  /** @private */
+  doubleClick: function(evt) {
+    var splitView = this.get('splitView');
+    return (splitView) ? splitView.doubleClickInThumbView(evt, this) : sc_super();
+  },
+  
+  /** @private */
+  touchStart: function(evt){
+    return this.mouseDown(evt);
+  }
+  
+});

data/lib/frameworks/sproutcore/frameworks/desktop/views/stacked.js

@@ -0,0 +1,121 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+sc_require('views/collection') ;
+
+/**
+  @class 
+
+  A StackedView is a CollectionView that expects its content to use static 
+  layout to stack vertically.  This type of collection view is not designed 
+  for use with large size collections, but it can be very useful for 
+  collections with complex displays and variable heights such as comments or
+  small notification queues.
+  
+  ## Static Layout
+  
+  This view makes no attempt to size or position your child views.  It assumes
+  you are using StaticLayout for your child views.  If you don't enable static
+  layout your views will probably overlay on top of eachother and will look 
+  incorrect.
+
+  Note also that the default layout for this view set's the height to "auto".
+  This is usually the behavior you will want. 
+  
+  @extends SC.CollectionView
+  @since SproutCore 0.9
+*/
+SC.StackedView = SC.CollectionView.extend(
+/** @scope SC.StackedView.prototype */ {
+  
+  /**
+    @type Array
+    @default ['sc-stacked-view']
+    @see SC.View#classNames
+  */
+  classNames: ['sc-stacked-view'],
+  
+  /** 
+    Default layout for a stacked view will fill the parent view but auto-
+    adjust the height of the view.
+    
+    @type Hash
+    @default `{ top: 0, left: 0, right: 0, height: 1 }`
+    @see SC.View#layout
+  */
+  layout: { top: 0, left: 0, right: 0, height: 1 },
+  
+  /**
+    Return full range of its indexes for nowShowing
+    
+    @param {Rect} rect
+    @returns {SC.IndexSet} full range of indexes
+  */
+  computeNowShowing: function(rect) {
+    return this.get('allContentIndexes');
+  },  
+
+  /**
+    Updates the height of the stacked view to reflect the current content of 
+    the view.  This is called automatically whenever an item view is reloaded.
+    You can also call this method directly if the height of one of your views
+    has changed.
+    
+    The height will be recomputed based on the actual location and dimensions
+    of the last child view.
+    
+    Note that normally this method will defer actually updating the height
+    of the view until the end of the run loop.  You can force an immediate 
+    update by passing YES to the "immediately" parameter.
+    
+    @param {Boolean} immediately YES to update immedately
+    @returns {SC.StackedView} receiver
+  */
+  updateHeight: function(immediately) {
+    if (immediately) this._updateHeight();
+    else this.invokeLast(this._updateHeight);
+    // ^ use invokeLast() here because we need to wait until all rendering has 
+    //   completed.
+    
+    return this;
+  },
+  
+  /** @private */
+  _updateHeight: function() {
+    
+    var childViews = this.get('childViews'),
+        len        = childViews.get('length'),
+        view, layer, height;
+        
+    if (len === 0) {
+      height = 1; 
+    } else {
+      view = childViews.objectAt(len-1);
+      layer = view ? view.get('layer') : null ;
+      height = layer ? (layer.offsetTop + layer.offsetHeight) : 1 ;
+      layer = null ; // avoid memory leaks
+    }
+    this.adjust('height', height);
+  },
+  
+  // ..........................................................
+  // INTERNAL SUPPORT
+  // 
+
+  /** @private
+    Whenever the collection view reloads some views, reset the cache on the
+    frame as well so that it will recalculate.
+  */
+  didReload: function(set) { return this.updateHeight(); },
+
+  /** @private
+    When layer is first created, make sure we update the height using the 
+    newly calculated value.
+  */
+  didCreateLayer: function() { return this.updateHeight(); }
+  
+});

data/lib/frameworks/sproutcore/frameworks/desktop/views/static_content.js

@@ -0,0 +1,148 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/** @class
+
+  StaticContentView allows you to display arbitrary HTML content inside your
+  view hierarchy.
+
+  Normally, views in SproutCore are absolutely positioned. Their width and
+  height are either pre-determined, or specified relative to their enclosing
+  view. Occasionally, you may want to display content that is layed out by
+  the browser. For example, if you were writing a documentation browser, you
+  may want to display the table of contents as an SC.ListView, but the actual
+  pages as HTML content.
+
+  This class is most useful when placed inside a ScrollView.
+
+  To use it, simply set the `content` property to a string of the HTML you
+  would like to display.
+
+  @extends SC.View
+  @since SproutCore 1.2
+  @author Tom Dale
+*/
+SC.StaticContentView = SC.View.extend(SC.StaticLayout,
+/** @scope SC.StaticContentView.prototype */ {
+
+  /**
+    @type Array
+    @default ['sc-static-content-view']
+    @see SC.View#classNames
+  */
+  classNames: ['sc-static-content-view'],
+
+  /**
+    @type Array
+    @default ['content']
+    @see SC.View#displayProperties
+  */
+  displayProperties: ['content'],
+
+
+  // ..........................................................
+  // PROPERTIES
+  //
+
+  /**
+    The HTML content you wish to display. This will be inserted directly into
+    the DOM, so ensure that any user-generated content has been escaped.
+
+    @type String
+    @default null
+  */
+  content: null,
+
+  // ..........................................................
+  // METHODS
+  //
+
+  /**
+    Because SproutCore has no way of knowing when the size of the content
+    inside a StaticContentView has changed, you should call this method
+    whenever an event that may change the size of the content occurs.
+
+    Note that if you change the content property, this will be recalculated
+    automatically.
+  */
+  contentLayoutDidChange: function() {
+    this._viewFrameDidChange();
+  },
+
+  // ..........................................................
+  // INTERNAL SUPPORT
+  //
+
+  /** @private
+    Disable SproutCore management of view positioning.
+  */
+  useStaticLayout: YES,
+
+  /** @private
+    Overrides SC.View's frame computed property, and returns a value from the
+    DOM. This value is cached to improve performance.
+
+    If the size of the content inside the view changes, you should call
+    contentLayoutDidChange().
+
+    @property
+  */
+  frame: function() {
+    var layer = this.get('layer'), rect;
+
+    if (!layer) return { x: 0, y: 0, width: 0, height: 0 };
+
+    if (layer.getBoundingClientRect) {
+      rect = layer.getBoundingClientRect();
+
+      return { x: 0, y: 0, width: rect.width, height: rect.height };
+    } else {
+      return { x: 0, y: 0, width: layer.clientWidth, height: layer.clientHeight };
+    }
+  }.property('content').cacheable(),
+
+  /** @private
+    Recalculate content frame if our parent view resizes.
+  */
+  parentViewDidResize: function() {
+    this.contentLayoutDidChange();
+  },
+
+  /** @private
+    If the layer changes, make sure we recalculate the frame.
+  */
+  didUpdateLayer: function() {
+    this.contentLayoutDidChange();
+  },
+
+  /** @private
+    Outputs the content property to the DOM.
+
+    @param {SC.RenderContext} context
+    @param {Boolean} firstTime
+  */
+  render: function(context, firstTime) {
+    var content = this.get('content');
+
+    if (content) {
+      context.push(content||'');
+    }
+  },
+  
+  /** @private */
+  touchStart: function(evt){
+    evt.allowDefault();
+    return YES;
+  },
+  
+  /** @private */
+  touchEnd: function(evt){
+    evt.allowDefault();
+    return YES;
+  }
+  
+});

data/lib/frameworks/sproutcore/frameworks/desktop/views/tab.js

@@ -0,0 +1,286 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+sc_require('views/segmented');
+
+/**
+  @static
+  @type String
+  @constant
+*/
+SC.TOP_LOCATION = 'top';
+
+/**
+  @static
+  @type String
+  @constant
+*/
+SC.TOP_TOOLBAR_LOCATION = 'top-toolbar';
+
+/**
+  @static
+  @type String
+  @constant
+*/
+SC.BOTTOM_LOCATION = 'bottom';
+
+/** 
+  @class
+
+  Incorporates a segmented view and a container view to display the selected
+  tab.  Provide an array of items, which will be passed onto the segmented
+  view.
+  
+  @extends SC.View
+  @since SproutCore 1.0
+*/
+SC.TabView = SC.View.extend(
+/** @scope SC.TabView.prototype */ {
+
+  /**
+    @type Array
+    @default ['sc-tab-view']
+    @see SC.View#classNames
+  */
+  classNames: ['sc-tab-view'],
+  
+  /**
+    @type Array
+    @default ['nowShowing']
+    @see SC.View#displayProperties
+  */
+  displayProperties: ['nowShowing'],
+
+  // ..........................................................
+  // PROPERTIES
+  // 
+
+ /** 
+    Set nowShowing with the page you want to display.
+    
+    @type String
+    @default null
+  */
+  nowShowing: null,
+  
+  /**
+    @type Array
+    @default []
+  */
+  items: [],
+  
+  /**
+    @type Boolean
+    @default YES
+  */
+  isEnabled: YES,
+  
+  /**
+    @type String
+    @default null
+  */
+  itemTitleKey: null,
+  
+  /**
+    @type String
+    @default null
+  */
+  itemValueKey: null,
+  
+  /**
+    @type String
+    @default null
+  */
+  itemIsEnabledKey: null,
+  
+  /**
+    @type String
+    @default null
+  */
+  itemIconKey: null,
+  
+  /**
+    @type String
+    @default null
+  */
+  itemWidthKey: null,
+  
+  /**
+    @type String
+    @default null
+  */
+  itemToolTipKey: null,
+  
+  /**
+    @type Number
+    @default SC.REGULAR_BUTTON_HEIGHT
+  */
+  tabHeight: SC.REGULAR_BUTTON_HEIGHT,
+  
+  /**
+    Possible values:
+    
+      - SC.TOP_LOCATION
+      - SC.TOP_TOOLBAR_LOCATION
+      - SC.BOTTOM_LOCATION
+    
+    @type String
+    @default SC.TOP_LOCATION
+  */
+  tabLocation: SC.TOP_LOCATION,
+  
+  /** 
+    If set, then the tab location will be automatically saved in the user
+    defaults.  Browsers that support localStorage will automatically store
+    this information locally.
+    
+    @type String
+    @default null
+  */
+  userDefaultKey: null,
+  
+  
+  // ..........................................................
+  // FORWARDING PROPERTIES
+  // 
+  
+  // forward important changes on to child views
+  /** @private */
+  _tab_nowShowingDidChange: function() {
+    var v = this.get('nowShowing');
+    this.get('containerView').set('nowShowing',v);
+    this.get('segmentedView').set('value',v);
+    return this ;
+  }.observes('nowShowing'),
+
+  /** @private */
+  _tab_saveUserDefault: function() {
+    // if user default is set, save also
+    var v = this.get('nowShowing');
+    var defaultKey = this.get('userDefaultKey');
+    if (defaultKey) {
+      SC.userDefaults.set([defaultKey,'nowShowing'].join(':'), v);
+    }
+  }.observes('nowShowing'),
+  
+  /** @private */
+  _tab_itemsDidChange: function() {
+    this.get('segmentedView').set('items', this.get('items'));
+    return this ;    
+  }.observes('items'),
+
+  /** @private
+    Restore userDefault key if set.
+  */
+  init: function() {
+    sc_super();
+    this._tab_nowShowingDidChange()._tab_itemsDidChange();
+  },
+
+  /** @private */
+  awake: function() {
+    sc_super();  
+    var defaultKey = this.get('userDefaultKey');
+    if (defaultKey) {
+      defaultKey = [defaultKey,'nowShowing'].join(':');
+      var nowShowing = SC.userDefaults.get(defaultKey);
+      if (!SC.none(nowShowing)) this.set('nowShowing', nowShowing);
+    }
+
+  },
+  
+  /** @private */
+  createChildViews: function() {
+    var childViews  = [], view, containerView, layout,
+        tabLocation = this.get('tabLocation'),
+        tabHeight   = this.get('tabHeight');
+
+    if (tabLocation === SC.TOP_LOCATION) {
+      layout = { top: tabHeight/2+1, left: 0, right: 0, bottom: 0, border: 1 };
+    } else if (tabLocation === SC.TOP_TOOLBAR_LOCATION) {
+      layout = { top: tabHeight+1, left: 0, right: 0, bottom: 0, border: 1 };
+    } else {
+      layout = { top: 0, left: 0, right: 0, bottom: (tabHeight/2) - 1, border: 1 };
+    }
+
+    containerView = this.containerView.extend({
+      layout: layout,
+      //adding the role
+      ariaRole: 'tabpanel'
+    });
+
+    view = this.containerView = this.createChildView(containerView) ;
+    childViews.push(view);
+    
+    //  The segmentedView managed by this tab view.  Note that this TabView uses
+    //  a custom segmented view.  You can access this view but you cannot change
+    // it.
+    layout = (tabLocation === SC.TOP_LOCATION || 
+              tabLocation === SC.TOP_TOOLBAR_LOCATION) ?
+             { height: tabHeight, left: 0, right: 0, top: 0 } :
+             { height: tabHeight, left: 0, right: 0, bottom: 0 } ;
+
+    this.segmentedView = this.get('segmentedView').extend({
+      layout: layout,
+
+      /** @private
+        When the value changes, update the parentView's value as well.
+      */
+      _sc_tab_segmented_valueDidChange: function() {
+        var pv = this.get('parentView');
+        if (pv) pv.set('nowShowing', this.get('value'));
+
+        // FIXME: why is this necessary? 'value' is a displayProperty and should
+        // automatically cause displayDidChange() to fire, which should cause 
+        // the two lines below to execute in the normal course of things...
+        this.set('layerNeedsUpdate', YES) ;
+        this.invokeOnce(this.updateLayerIfNeeded) ;
+      }.observes('value'),
+
+      /** @private */
+      init: function() {
+        // before we setup the rest of the view, copy key config properties 
+        // from the owner view...
+        var pv = this.get('parentView');
+        if (pv) {
+          SC._TAB_ITEM_KEYS.forEach(function(k) { this[k] = pv.get(k); }, this);
+        }
+        return sc_super();
+      }
+    });
+    
+    view = this.segmentedView = this.createChildView(this.segmentedView) ;
+    childViews.push(view);
+    
+    this.set('childViews', childViews);
+    return this; 
+  },
+  
+  // ..........................................................
+  // COMPONENT VIEWS
+  // 
+
+  /**
+    The containerView managed by this tab view.  Note that TabView uses a 
+    custom container view.  You can access this view but you cannot change 
+    it.
+    
+    @type SC.View
+    @default SC.ContainerView
+    @readOnly
+  */
+  containerView: SC.ContainerView.extend({ renderDelegateName: 'wellRenderDelegate' }),
+  
+  /**
+    @type SC.View
+    @default SC.SegmentedView
+  */
+  segmentedView: SC.SegmentedView
+  
+}) ;
+
+SC._TAB_ITEM_KEYS = ['itemTitleKey', 'itemValueKey', 'itemIsEnabledKey', 'itemIconKey', 'itemWidthKey', 'itemToolTipKey', 'itemActionKey', 'itemTargetKey'];

data/lib/frameworks/sproutcore/frameworks/desktop/views/thumb.js

@@ -0,0 +1,65 @@
+// ==========================================================================
+// Project:   SproutCore - JavaScript Application Framework
+// Copyright: ©2006-2011 Strobe Inc. and contributors.
+//            Portions ©2008-2011 Apple Inc. All rights reserved.
+// License:   Licensed under MIT license (see license.js)
+// ==========================================================================
+
+/**
+  @class
+
+  A ThumbView works in concert with SC.SplitView to adjust the divider 
+  position from an arbitrary subview of the SplitView. Simply make an
+  instance of ThumbView a child somewhere in the childViews (or 
+  descendants) of the split view and add the path to the ThumbView to the
+  SplitView's thumbViews array.
+  
+  SplitView will automatically set the splitView property of the views in
+  its thumbViews array.
+
+  @extends SC.View
+  @author Erich Ocean
+  @test in split
+*/
+SC.ThumbView = SC.View.extend(
+/** @scope SC.ThumbView.prototype */ {
+
+  /**
+    @type Array
+    @default ['sc-thumb-view']
+    @see SC.View#classNames
+  */
+  classNames: ['sc-thumb-view'],
+  
+  /**
+    Enable this thumb view to control its parent split view.
+    
+    @type Boolean
+    @default YES
+  */
+  isEnabled: YES,
+  
+  /** @private */
+  isEnabledBindingDefault: SC.Binding.bool(),
+  
+  /** @private */
+  prepareContext: function(context, firstTime) {
+    var splitView = this.get('splitView') ;
+    if (splitView) this.set('cursor', splitView.get('thumbViewCursor')) ;
+    return sc_super() ;
+  },
+  
+  /** @private */
+  mouseDown: function(evt) {
+    if (!this.get('isEnabled')) return NO ;
+    
+    var splitView = this.get('splitView');
+    return (splitView) ? splitView.mouseDownInThumbView(evt, this) : sc_super();
+  },
+  
+  /** @private */
+  touchStart: function(evt) {
+    return this.mouseDown(evt);
+  }
+
+});