sproutcore 0.9.14 → 0.9.15

data/frameworks/sproutcore/foundation/string.js

@@ -5,30 +5,47 @@
 
 // These are basic enhancements to the string class used throughout 
 // SproutCore.
-// capitalize a string.
-Object.extend(String.prototype,{
-
-  // Capitalize a string.
-  //
-  // mode: optional.  'each' - capitalize each word. the default.
-  //                  'first' - capitalize the first word only.
-  
-  capitalize: function(mode) {
-    var words = (mode == 'first') ? this : this.split(' ') ;
-    words = words.map(function(word) {
-      if (word.length == 0) return word ;
-      return word.charAt(0).toUpperCase() + word.substring(1) ;
-    }) ;
-    return words.join(' ') ;
-  },
 
+SC.STRING_TITLEIZE_REGEXP = (/([\s|\-|\_|\n])([^\s|\-|\_|\n]?)/g);
+
+/**
+  @namespace
+  
+  SproutCore implements a variety of enhancements to the built-in String 
+  object that make it easy to perform common substitutions and conversions.
+  
+  Most of the utility methods defined here mirror those found in Prototype
+  1.6.
+  
+  @since SproutCore 1.0
+*/
+SC.String = {
+  
   // Interpolate string. looks for %@ or %@1; to control the order of params.
-  format: function() {
-    var args = $A(arguments) ;
+  /**
+    Apply formatting options to the string.  This will look for occurrences
+    of %@ in your string and substitute them with the arguments you pass into
+    this method.  If you want to control the specific order of replacement, 
+    you can add a number after the key as well to indicate which argument 
+    you want to insert.  
+
+    Ordered insertions are most useful when building loc strings where values
+    you need to insert may appear in different orders.
+
+    h3. Examples
     
+    {{{
+      "Hello %@ %@".fmt('John', 'Doe') => "Hello John Doe"
+      "Hello %@2, %@1".fmt('John', 'Doe') => "Hello Doe, John"
+    }}}
+    
+    @param args {Object...} optional arguments
+    @returns {String} formatted string
+  */
+  fmt: function() {
     // first, replace any ORDERED replacements.
     var str = this.gsub(/%@([0-9]+)/, function(m) {
-      return (args[parseInt(m[1],0)-1] || '').toString(); 
+      return (arguments[parseInt(m[1],0)-1] || '').toString(); 
     }) ;
 
     // now, replace any remaining %@ items.  Use this indexOf() method b/c
@@ -36,13 +53,14 @@ Object.extend(String.prototype,{
     var ret = [] ;
     var idx = -1 ;
     var loc = 0 ;
+    var argIdx = 0;
     while((idx = str.indexOf("%@",loc)) >= 0) {
      // slice off initial part of string and push into ret. update loc.
      ret.push(str.slice(loc,idx)) ;
      loc = idx + 2 ; // 2 to skip '%@'.
      
      // add in replacement.
-     var value = args.shift() ;
+     var value = arguments[argIdx++] ;
      if (value && value.toString) value = value.toString() ;
      ret.push(value) ;
     }
@@ -56,8 +74,15 @@ Object.extend(String.prototype,{
     return (ret.length > 1) ? ret.join('') : ret[0] ;
   },
 
-  // localize a string.  Also interpolates any items you pass just like
-  // format().
+  /**
+    Localizes the string.  This will look up the reciever string as a key 
+    in the current Strings hash.  If the key matches, the loc'd value will be
+    used.  The resulting string will also be passed through fmt() to insert
+    any variables.
+    
+    @param args {Object...} optional arguments to interpolate also
+    @returns {String} the localized and formatted string.
+  */
   loc: function() {
     // NB: This could be implemented as a wrapper to locWithDefault() but
     // it would add some overhead to deal with the arguments and adds stack
@@ -66,60 +91,139 @@ Object.extend(String.prototype,{
     var kit = String[String.currentLanguage()];
     var str = kit[this] ;
     if (!str) str = String.English[this] || this ;
-    return str.format.apply(str,arguments) ;
+    return str.fmt.apply(str,arguments) ;
   },
-  
-  // this works just like loc except it will return the first argument
-  // as a default if the matching value is not found.
+
+  /**
+    Works just like loc() except that it will return the passed default 
+    string if a matching key is not found.
+    
+    @param def {String} the default to return
+    @param args {Object...} optional formatting arguments
+    @returns {String} localized and formatted string
+  */
   locWithDefault: function(def) {
     var kit = String[String.currentLanguage()];
     var str = kit[this] ;
     if (!str) str = String.English[this] || def ;
-    var args = $A(arguments) ;
+    var args = SC.$A(arguments) ;
     args.shift() ; // escape def.
-    return str.format.apply(str, args) ;
+    return str.fmt.apply(str, args) ;
+  },
+  
+  /** 
+    Capitalizes a string.
+    @return {String} capitalized string
+  */
+  capitalize: function() {
+    return this.charAt(0).toUpperCase() + this.substring(1) ;
+  },
+
+  /**
+    Capitalized every word in the string, separated by spaces or dashes.
+    @return {String} titleized string.
+  */
+  titleize: function() {
+    return this.replace(SC.STRING_TITLEIZE_REGEXP, 
+      function(str,separater,character) { 
+        return (character) ? (' ' + character.toUpperCase()) : ' ';
+      }).capitalize() ;
+  },
+  
+  /**
+    Camelizes a string.  This will take any words separated by spaces, dashes
+    or underscores and convert them into camelCase.
+    
+    h3. Examples
+    
+    {{{
+      "my favorite items".camelize() => "myFavoriteItems"
+      "css-class-name".camelize() => "cssClassName"  
+      "action_name".camelize() => "actionName" 
+    }}}
+    
+    @returns {String} camelized string
+  */
+  camelize: function() {
+    var parts = this.split('-'), len = parts.length;
+    if (len == 1) return parts[0];
+
+    var camelized = this.charAt(0) == '-'
+      ? parts[0].charAt(0).toUpperCase() + parts[0].substring(1)
+      : parts[0];
+
+    for (var i = 1; i < len; i++)
+      camelized += parts[i].charAt(0).toUpperCase() + parts[i].substring(1);
+
+    return camelized;
   },
+
   
+  /**
+    Converts the string into a class name.  This method will camelize your 
+    string and then capitalize the first letter.
+  */
   classify: function() {
     return this.camelize().capitalize() ;
   },
   
+  /**
+    Converts a camelized string into all lower case separated by underscores.
+    
+    @returns {String} the decamelized string.
+  */
   decamelize: function() { 
     return this.replace(/([a-z])([A-Z])/g,'$1_$2').toLowerCase();
   },
 
+  /**
+    Converts a camelized string or a string with spaces or underscores into
+    a string with components separated by dashes.
+    
+    @returns {String} the dasherized string.
+  */
   dasherize: function() {
     return this.decamelize().replace(/[ _]/g,'-') ;  
   },
   
+  /**
+    Converts a camelized string or a string with dashes or underscores into
+    a string with components separated by spaces.
+    
+    @returns {String} the humanized string.
+  */
   humanize: function() {
     return this.decamelize().replace(/[-_]/g,' ') ;
   },
   
-  toHref: function() {
-    if (this.match(/.+@.+\...+/)) {
-      return 'mailto:' + this;
-    } else if (this.indexOf('http://') != 0 && this.indexOf('https://') !=0 && this.match(/[^.]+\.[^.]+/)) {
-      return 'http://' + this;
-    } else {
-      return this;
-    }
-  },
-  
-  trim: function ()
-  {
+  /**
+    Removes any extra whitespace from the edges of the strings.
+    
+    This method is also aliased as strip().
+    
+    @returns {String} the trimmed string
+  */
+  trim: function () {
     return this.replace(/^\s+|\s+$/g,"");
   },
-  
-  strip: function()
-  {
-    return this.trim();
+
+  /**
+    Explodes a string into an array of characters.
+    
+    @returns {Array}
+  */
+  toArray: function() {
+    return this.split('');
   }
   
-}) ;
+} ;
+
+// Deprecated, longer version of this method.
+SC.String.format = SC.String.fmt;
+SC.String.strip = SC.String.trim; // convenience alias.
 
-// Shorter alias of the format function.
-String.prototype.fmt = String.prototype.format ;
+// Apply SC.String mixin to built-in String object
+SC.mixin(String.prototype, SC.String) ;
 
 // Add strings for various languages to this collection.  String.loc()
 // method will try to localize the string passed using the current language.

data/frameworks/sproutcore/foundation/utils.js

@@ -6,10 +6,75 @@
 // These are helpful utility functions for calculating range and rect values
 
 
-Object.extend(SC, 
+SC.mixin( 
 /** @scope SC */
 {
 
+  _downloadFrames: 0, // count of download frames inserted into document
+  
+  /**
+    Starts a download of the file at the named path.
+    
+    Use this method when you want to cause a file to be downloaded to a users
+    desktop instead of having it display in the web browser.  Note that your
+    server must return a header indicating that the file is intended for 
+    download also.
+  */
+  download: function(path) {
+    var tempDLIFrame=document.createElement('iframe');
+    var frameId = 'DownloadFrame_' + this._downloadFrames;
+    tempDLIFrame.setAttribute('id',frameId);
+    tempDLIFrame.style.border='10px';
+    tempDLIFrame.style.width='0px';
+    tempDLIFrame.style.height='0px';
+    tempDLIFrame.style.position='absolute';
+    tempDLIFrame.style.top='-10000px';
+    tempDLIFrame.style.left='-10000px';    
+    // Don't set the iFrame content yet if this is Safari
+    if (!(SC.isSafari())) {
+      tempDLIFrame.setAttribute('src',path);
+    }
+    document.getElementsByTagName('body')[0].appendChild(tempDLIFrame);
+    if (SC.isSafari()) {
+      tempDLIFrame.setAttribute('src',path);    
+    }
+    this._downloadFrames = this._downloadFrames + 1;
+    if (!(SC.isSafari())) {
+      var r = function() { 
+        document.body.removeChild(document.getElementById(frameId)); 
+        frameId = null;
+      } ;
+      var t = r.invokeLater(null, 2000);
+    }
+    //remove possible IE7 leak
+    tempDLIFrame = null;
+  },
+
+  /**
+    Takes a URL of any type and normalizes it into a fully qualified URL with
+    hostname.  For example:
+    
+    {{{
+      "some/path" => "http://localhost:4020/some/path" 
+      "/some/path" => "http://localhost:4020/some/path"
+      "http://localhost:4020/some/path" => "http://localhost:4020/some/path"
+    }}}
+    
+    @param url {String} the URL
+    @returns {String} the normalized URL
+  */
+  normalizeURL: function(url) {
+    if (url.slice(0,1) == '/') {
+      url = window.location.protocol + '//' + window.location.host + url ;
+    } else if ((url.slice(0,5) == 'http:') || (url.slice(0,6) == 'https:')) {
+      // no change
+    } else {
+      url = window.location.href + '/' + url ;
+    }
+    return url ;
+  },
+  
+  
   /** Return the left edge of the frame */
   minX: function(frame) { 
     return frame.x; 
@@ -142,9 +207,17 @@ Object.extend(SC,
 
     // add up all the offsets for the element.
     var element = el ;
+    var isFirefox3 = SC.Platform.Firefox >= 3 ;
     while (element) {
-      valueT += (element.offsetTop  || 0) + (element.clientTop  || 0);
-      valueL += (element.offsetLeft || 0) + (element.clientLeft || 0);
+      valueT += (element.offsetTop  || 0);
+      if (!isFirefox3 || (element !== el)) {
+        valueT += (element.clientTop  || 0);
+      }
+
+      valueL += (element.offsetLeft || 0);
+      if (!isFirefox3 || (element !== el)) {
+        valueL += (element.clientLeft || 0);
+      }
 
       // bizarely for FireFox if your offsetParent has a border, then it can 
       // impact the offset. 
@@ -158,6 +231,14 @@ Object.extend(SC,
           }
           valueL += left; valueT += top ;
         }
+        
+        // In FireFox 3 -- the offsetTop/offsetLeft subtracts the clientTop/
+        // clientLeft of the offset parent.
+        var offsetParent = element.offsetParent ;
+        if ((SC.Platform.Firefox >= 3) && offsetParent) {
+          valueT -= offsetParent.clientTop ;
+          valueL -= offsetParent.clientLeft;
+        }
       }
 
       // Safari fix

data/frameworks/sproutcore/lib/collection_view.rb

@@ -32,6 +32,7 @@ view_helper :collection_view do
   property :can_delete_content
   
   property :content_icon_key
+  property :content_checkbox_key
   
   # Unless the developer passes something specific, automatically enable
   # has_content_icon if either icon property is specified.

data/frameworks/sproutcore/license.js

@@ -0,0 +1,28 @@
+//@license
+// ==========================================================================
+// SproutCore -- JavaScript Application Framework
+// copyright 2006-2008, Sprout Systems, Inc. and contributors.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a 
+// copy of this software and associated documentation files (the "Software"), 
+// to deal in the Software without restriction, including without limitation 
+// the rights to use, copy, modify, merge, publish, distribute, sublicense, 
+// and/or sell copies of the Software, and to permit persons to whom the 
+// Software is furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in 
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
+// DEALINGS IN THE SOFTWARE.
+//
+// For more information about SproutCore, visit http://www.sproutcore.com
+//
+//
+// ==========================================================================
+//@license