sproutit-sproutcore 1.0.20090721145236 → 1.0.20090721145251

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

@@ -0,0 +1,136 @@
+// ==========================================================================
+// 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 });
+  }    
+
+});

data/frameworks/sproutcore/frameworks/foundation/debug/control_test_pane.js

@@ -0,0 +1,194 @@
+// ==========================================================================
+// 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)
+// ==========================================================================
+
+sc_require('panes/pane');
+
+/*global test */
+
+// TODO: IMPROVE CODE QUALITY.  This code was put together quickly in order to
+// test the SproutCore framework.  It does not match up to the project's 
+// normal documentation, design and coding standards.  Do not rely on this 
+// code as an example of how to build your own applications.
+
+/** @class
+  Generates a pane that will display vertically stacked views for testing.
+  You can use this class in test mode to easily create a palette with views
+  configured in different ways.
+  
+  h1. Example
+  
+  {{{
+    var pane = SC.ControlTestPane.design()
+      .add('basic', SC.CheckboxView.design({ title: "Hello World" }))
+      .add('disabled', SC.CheckboxView.design({
+        title: "Hello World", isEnabled: NO
+      }));
+      
+    module("CheckboxView UI", pane);
+    
+    test("basic", function() {
+      var view = pane.view('basic');
+      ok(view.get('isEnabled'), 'should be enabled');
+    });
+  }}}
+  
+  @extends SC.Pane
+  @since SproutCore 1.0
+*/
+SC.ControlTestPane = SC.Pane.extend(
+/** @scope SC.ControlTestPane.prototype */ {
+  
+  classNames: ['sc-control-test-pane'],
+  layout: { right: 5, width: 350, top: 75, bottom: 5 },
+
+  /**
+    The starting top location for the first row.  This will increment as 
+    views are added to the pane.
+  */
+  top:       0,
+  
+  /**
+    The default height of each row.  This will be used for a view unless you
+    manually specify a height in the view's layout.
+  */
+  height:    20,
+  
+  /**
+    The default padding added to the edges and between each row.
+  */
+  padding:   4,
+
+  /**
+    Retrieves the test sample view that was added with the passed key name.
+    
+    @param {String} keyName the key used to register the view.
+    @returns {SC.View} view instance
+  */
+  view: function(keyName) { 
+    var idx = this._views[keyName];
+    if (!idx) throw "SC.ControlTestPane does not have a view named %@".fmt(keyName);
+    return this.childViews[idx].childViews[0]; 
+  },
+  
+  init: function() {
+    sc_super();
+    if (!this._views) this._views = {};
+    this.append(); // auto-add to screen
+    
+    // Also adjust unit test results to make space
+    // use setTimeout to avoid screwing with the RunLoop which we might be 
+    // testing.
+    var l = this.get('layout'), w = l.right + l.width;
+    setTimeout(function() {
+      if (!Q$) return ; // nothing to do
+      Q$('.core-test > .detail').css('marginRight', w);
+    }, 100);
+  }
+});
+
+/**
+  Adds a test view to the control pane design.  The passed label will be used
+  as the key which you can use to find the view layer.  You can either pass
+  a view that is already designed or pass an array of attributes that will be
+  used to create a design on the view.
+  
+  @param {String} label the view key name
+  @param {SC.View} view a view class or view design
+  @param {Hash} attrs optional attrs to use when designing the view
+  @returns {SC.ControlTestPane} receiver
+*/
+SC.ControlTestPane.add = function(label, view, attrs) {
+  if (attrs === undefined) attrs = {};
+  if (!view.isDesign) view = view.design(attrs);
+
+  // compute layout.
+  var padding = this.prototype.padding, height = this.prototype.height;
+  var top = this.prototype.top + padding*2, layout;
+  var labelHeight =14;
+  if (top === padding*2) top = padding; // reduce padding @ top
+  
+  // if the passed in view has a layout property and the layout has an 
+  // explicit, numerical height, then use that instead.
+  if (view.prototype.layout && (typeof view.prototype.layout.height === SC.T_NUMBER)) height = view.prototype.layout.height;
+  
+  this.prototype.top = top + height+labelHeight+(padding*2); // make room
+  
+  // calculate labelView and add it
+  layout = { left: padding, width: 150, top: top, height: 20 };
+  var labelView = SC.LabelView.design({
+    value: label + ':', 
+    layout: { left: 0, right: 0, top: 0, height: labelHeight }, 
+   // textAlign: SC.ALIGN_RIGHT, 
+    fontWeight: SC.BOLD_WEIGHT 
+  });
+
+  // wrap label in parent view in order to center text vertically
+  labelView = SC.View.design().layout(layout).childView(labelView);
+  this.childView(labelView);
+  
+  // now layout view itself...
+  var wrapper = SC.View.design({
+    classNames: ['wrapper'],
+    layout: { left: padding, top: top+labelHeight+padding, right: padding, height: height },
+    childViews: [view]
+  });
+  var idx = this.prototype.childViews.length ;
+  this.childView(wrapper);
+  
+  var views = this.prototype._views;
+  if (!views) views = this.prototype._views = {};
+  views[label] = idx ;
+  
+  return this;
+};
+
+/**
+  Returns a standard setup/teardown object for use by the module() method.
+*/
+SC.ControlTestPane.standardSetup = function() {
+  var pane = this ;
+  return {
+    setup: function() { 
+      SC.RunLoop.begin();
+      pane._pane = pane.create(); 
+      SC.RunLoop.end();
+    },
+    
+    teardown: function() {
+      SC.RunLoop.begin();
+      if (pane._pane) pane._pane.remove();
+      SC.RunLoop.end();
+      
+      pane._pane = null ;
+    }
+  } ;
+};
+
+/**
+  Convenience method.  Returns the view with the given name on the current
+  pane instance if there is one.
+*/
+SC.ControlTestPane.view = function(viewKey) {
+  var pane = this._pane || this._showPane ;
+  if (!pane) throw "view() cannot be called on a class";
+  return pane.view(viewKey);
+};
+
+/**
+  Registers a final test that will instantiate the control test pane and 
+  display it.  This allows the developer to interact with the controls once
+  the test has completed.
+*/
+SC.ControlTestPane.show = function() {
+  var pane = this ;
+  test("show control test pane", function() { 
+    SC.RunLoop.begin();
+    pane._showPane = pane.create(); 
+    SC.RunLoop.end();
+  });
+};
+

data/frameworks/sproutcore/frameworks/foundation/english.lproj/bootstrap.rhtml

@@ -0,0 +1,68 @@
+<% 
+# ==========================================================================
+# 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)
+# ==========================================================================
+#
+# This file contains bootstrap code to be included at the top of standard 
+# SproutCore apps.  This code will autodetect the browser and then adds
+# a class name to the 'body' tag.  You can use this class name to customize
+# the CSS rules to be applied to your page based on browser.  The class name
+# contains the name webkit|mozilla|ie + the major version number
+#
+-%>
+<% content_for('bootstrap') do %>
+var SC = SC || {};
+SC.browser = (function() {
+  var userAgent = navigator.userAgent.toLowerCase();
+  var version = (userAgent.match( /.+(?:rv|it|ra|ie)[\/: ]([\d.]+)/ ) || [])[1] ;
+
+  var browser = {
+    version: version,
+    safari: (/webkit/).test( userAgent ) ? version : 0,
+    opera: (/opera/).test( userAgent ) ? version : 0,
+    msie: (/msie/).test( userAgent ) && !(/opera/).test( userAgent ) ? version : 0,
+    mozilla: (/mozilla/).test( userAgent ) && !(/(compatible|webkit)/).test( userAgent ) ? version : 0,
+    mobileSafari: (/apple.*mobile.*safari/).test(userAgent) ? version : 0,
+    windows: !!(/(windows)/).test(userAgent),
+    mac: !!((/(macintosh)/).test(userAgent) || (/(mac os x)/).test(userAgent)),
+    language: ((navigator.language || navigator.browserLanguage).split('-', 1)[0])
+  };
+  
+    browser.current = (browser.msie) ? 'msie' : (browser.mozilla) ? 'mozilla' : (browser.safari) ? 'safari' : (browser.opera) ? 'opera' : 'unknown' ;
+  return browser ;
+})();
+
+SC.setupBodyClassNames = function() {
+  var el = document.body ;
+  var browser, platform, shadows, borderRad, classNames;
+  if (!el) return ;
+  browser = SC.browser.current ;
+  platform = (SC.browser.windows) ? 'windows' : (SC.browser.mac) ? 'mac' : 'other-platform' ;
+  
+  shadows = (document.documentElement.style.MozBoxShadow !== undefined) || 
+                (document.documentElement.style.webkitBoxShadow !== undefined) ||
+                (document.documentElement.style.oBoxShadow !== undefined) ||
+                (document.documentElement.style.boxShadow !== undefined);
+  
+  borderRad = (document.documentElement.style.MozBorderRadius !== undefined) || 
+              (document.documentElement.style.webkitBorderRadius !== undefined) ||
+              (document.documentElement.style.oBorderRadius !== undefined) ||
+              (document.documentElement.style.borderRadius !== undefined);
+  
+  
+  classNames = (el.className) ? el.className.split(' ') : [] ;
+  if(shadows) classNames.push('box-shadow');
+  if(borderRad) classNames.push('border-rad');
+  classNames.push(browser) ;
+  classNames.push(platform) ;
+  if (SC.browser.mobileSafari) classNames.push('mobile-safari') ;
+  el.className = classNames.join(' ') ;
+} ;
+
+<% end %>
+<% content_for('setup_body_class_names') do %>
+if (SC.setupBodyClassNames) SC.setupBodyClassNames() ;
+<% end -%>

data/frameworks/sproutcore/frameworks/foundation/english.lproj/button_view.css

@@ -0,0 +1,55 @@
+/* SC.ButtonView */
+
+.sc-button-view.sc-static-layout {
+  margin: 0 4px;
+}
+
+.sc-button-view {
+  display: inline-block ;
+  vertical-align: middle;
+  background-color: #d0d0d0;
+  border: 1px #666 solid;
+  color: black;
+  text-decoration: none ;
+  font-weight: bold ;
+  
+  -webkit-border-radius: 2px;
+  -moz-border-radius: 2px;
+  border-radius: 2px;
+}
+
+.sc-button-view .sc-button-inner {
+  position: relative;
+  display:  block;
+  height: 100%;
+  text-align: center ;
+}
+
+.sc-button-view label {
+  position: relative;
+  display: block;
+  line-height: 21px;
+  text-align: center;
+}
+
+.sc-button-view img {
+  vertical-align: middle ;
+  margin-right: 2px;
+  position: relative ;
+  top: -2px;
+  left: -2px;
+}
+
+.sc-button-view.disabled,
+.sc-button-view.disabled.active {
+  background-color: #e0e0e0;
+  border: 1px #a0a0a0 solid ;
+  color: #a0a0a0;
+}
+
+.sc-button-view.active,
+.sc-button-view.sel {
+  background-color: #333;
+  border: 1px #333 solid ;
+  color: white;
+}