Upgrade to ExtJS 3.2.1 - Released 04/27/2010

[extjs.git] / docs / source / Ext.html
diff --git a/docs/source/Ext.html b/docs/source/Ext.html

index 57e45c9..ebc3d5a 100644 (file)
--- a/docs/source/Ext.html
+++ b/docs/source/Ext.html
@@ -1,12 +1,17 @@
-<html>\r
-<head>\r
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    \r
-  <title>The source code</title>\r
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
-</head>\r
-<body  onload="prettyPrint();">\r
-    <pre class="prettyprint lang-js">
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
+  <title>The source code</title>
+    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+</head>
+<body  onload="prettyPrint();">
+    <pre class="prettyprint lang-js">/*!
+ * Ext JS Library 3.2.1
+ * Copyright(c) 2006-2010 Ext JS, Inc.
+ * licensing@extjs.com
+ * http://www.extjs.com/license
+ */
  // for old browsers
  window.undefined = window.undefined;
  
@@ -21,7 +26,12 @@ Ext = {
       * The version of the framework
       * @type String
       */
-    version : '3.1.0'
+    version : '3.2.1',
+    versionDetail : {
+        major: 3,
+        minor: 2,
+        patch: 1
+    }
  };
  
  <div id="method-Ext-apply"></div>/**
@@ -55,7 +65,7 @@ Ext.apply = function(o, c, defaults){
          DOC = document,
          isStrict = DOC.compatMode == "CSS1Compat",
          isOpera = check(/opera/),
-        isChrome = check(/chrome/),
+        isChrome = check(/\bchrome\b/),
          isWebKit = check(/webkit/),
          isSafari = !isChrome && check(/safari/),
          isSafari2 = isSafari && check(/applewebkit\/4/), // unique to Safari 2
@@ -163,7 +173,11 @@ Ext.apply = function(o, c, defaults){
           * @return {String} The generated Id.
           */
          id : function(el, prefix){
-            return (el = Ext.getDom(el) || {}).id = el.id || (prefix || "ext-gen") + (++idSeed);
+            el = Ext.getDom(el, true) || {};
+            if (!el.id) {
+                el.id = (prefix || "ext-gen") + (++idSeed);
+            }
+            return el.id;
          },
  
          <div id="method-Ext-extend"></div>/**
@@ -225,7 +239,7 @@ MyGridPanel = Ext.extend(Ext.grid.GridPanel, {
              var oc = Object.prototype.constructor;
  
              return function(sb, sp, overrides){
-                if(Ext.isObject(sp)){
+                if(typeof sp == 'object'){
                      overrides = sp;
                      sp = sb;
                      sb = overrides.constructor != oc ? overrides.constructor : function(){sp.apply(this, arguments);};
@@ -406,7 +420,7 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2"
              }
              //NodeList has an item and length property
              //IXMLDOMNodeList has nextNode method, needs to be checked first.
-            return ((v.nextNode || v.item) && Ext.isNumber(v.length));
+            return ((typeof v.nextNode != 'undefined' || v.item) && Ext.isNumber(v.length));
          },
  
          <div id="method-Ext-each"></div>/**
@@ -473,7 +487,7 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2"
              if(Ext.isIterable(obj)){
                  Ext.each(obj, fn, scope);
                  return;
-            }else if(Ext.isObject(obj)){
+            }else if(typeof obj == 'object'){
                  for(var prop in obj){
                      if(obj.hasOwnProperty(prop)){
                          if(fn.call(scope || obj, prop, obj[prop], obj) === false){
@@ -486,6 +500,8 @@ Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", false); // returns {foo: "1", bar: ["2"
  
          <div id="method-Ext-getDom"></div>/**
           * Return the dom node for the passed String (id), dom node, or Ext.Element.
+         * Optional 'strict' flag is needed for IE since it can return 'name' and
+         * 'id' elements by using getElementById.
           * Here are some examples:
           * <pre><code>
  // gets dom node based on id
@@ -505,11 +521,29 @@ function(el){
           * @param {Mixed} el
           * @return HTMLElement
           */
-        getDom : function(el){
+        getDom : function(el, strict){
              if(!el || !DOC){
                  return null;
              }
-            return el.dom ? el.dom : (Ext.isString(el) ? DOC.getElementById(el) : el);
+            if (el.dom){
+                return el.dom;
+            } else {
+                if (typeof el == 'string') {
+                    var e = DOC.getElementById(el);
+                    // IE returns elements with the 'name' and 'id' attribute.
+                    // we do a strict check to return the element with only the id attribute
+                    if (e && isIE && strict) {
+                        if (el == e.getAttribute('id')) {
+                            return e;
+                        } else {
+                            return null;
+                        }
+                    }
+                    return e;
+                } else {
+                    return el;
+                }
+            }
          },
  
          <div id="method-Ext-getBody"></div>/**
@@ -643,7 +677,7 @@ function(el){
           * @return {Boolean}
           */
          isElement : function(v) {
-            return !!v && v.tagName;
+            return v ? !!v.tagName : false;
          },
  
          <div id="method-Ext-isDefined"></div>/**
@@ -998,6 +1032,6 @@ Ext.applyIf(Array.prototype, {
          return this;
      }
  });
-</pre>    \r
-</body>\r
+</pre>    
+</body>
  </html>
 \ No newline at end of file