Upgrade to ExtJS 3.3.0 - Released 10/06/2010

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

index 9e53749..ee8f1c2 100644 (file)
--- a/docs/source/CompositeField.html
+++ b/docs/source/CompositeField.html
@@ -7,7 +7,7 @@
  </head>
  <body  onload="prettyPrint();">
      <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.2.2
+ * Ext JS Library 3.3.0
   * Copyright(c) 2006-2010 Ext JS, Inc.
   * licensing@extjs.com
   * http://www.extjs.com/license
@@ -85,6 +85,10 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
       * @cfg {String} labelConnector The string to use when joining segments of the built label together (defaults to ', ')
       */
      labelConnector: ', ',
+    
+    <div id="cfg-Ext.form.CompositeField-defaults"></div>/**
+     * @cfg {Object} defaults Any default properties to assign to the child fields.
+     */
  
      //inherit docs
      //Builds the composite field label
@@ -99,7 +103,7 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
              labels.push(item.fieldLabel);
  
              //apply any defaults
-            Ext.apply(item, this.defaults);
+            Ext.applyIf(item, this.defaults);
  
              //apply default margins to each item except the last
              if (!(i == j - 1 && this.skipLastItemMargin)) {
@@ -128,6 +132,26 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
          });
  
          Ext.form.CompositeField.superclass.initComponent.apply(this, arguments);
+        
+        this.innerCt = new Ext.Container({
+            layout  : 'hbox',
+            items   : this.items,
+            cls     : 'x-form-composite',
+            defaultMargins: '0 3 0 0'
+        });
+        
+        var fields = this.innerCt.findBy(function(c) {
+            return c.isFormField;
+        }, this);
+
+        <div id="prop-Ext.form.CompositeField-items"></div>/**
+         * @property items
+         * @type Ext.util.MixedCollection
+         * Internal collection of all of the subfields in this Composite
+         */
+        this.items = new Ext.util.MixedCollection();
+        this.items.addAll(fields);
+        
      },
  
      /**
@@ -141,28 +165,11 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
               * @type Ext.Container
               * A container configured with hbox layout which is responsible for laying out the subfields
               */
-            var innerCt = this.innerCt = new Ext.Container({
-                layout  : 'hbox',
-                renderTo: ct,
-                items   : this.items,
-                cls     : 'x-form-composite',
-                defaultMargins: '0 3 0 0'
-            });
+            var innerCt = this.innerCt;
+            innerCt.render(ct);
  
              this.el = innerCt.getEl();
  
-            var fields = innerCt.findBy(function(c) {
-                return c.isFormField;
-            }, this);
-
-            <div id="prop-Ext.form.CompositeField-items"></div>/**
-             * @property items
-             * @type Ext.util.MixedCollection
-             * Internal collection of all of the subfields in this Composite
-             */
-            this.items = new Ext.util.MixedCollection();
-            this.items.addAll(fields);
-
              //if we're combining subfield errors into a single message, override the markInvalid and clearInvalid
              //methods of each subfield and show them at the Composite level instead
              if (this.combineErrors) {
@@ -192,7 +199,11 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
       */
      onFieldMarkInvalid: function(field, message) {
          var name  = field.getName(),
-            error = {field: name, error: message};
+            error = {
+                field: name, 
+                errorName: field.fieldLabel || name,
+                error: message
+            };
  
          this.fieldErrors.replace(name, error);
  
@@ -267,7 +278,7 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
          for (var i = 0, j = errors.length; i < j; i++) {
              error = errors[i];
  
-            combined.push(String.format("{0}: {1}", error.field, error.error));
+            combined.push(String.format("{0}: {1}", error.errorName, error.error));
          }
  
          return combined.join("<br />");
@@ -400,7 +411,10 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
  
      //override the behaviour to check sub items.
      setReadOnly : function(readOnly) {
-        readOnly = readOnly || true;
+        if (readOnly == undefined) {
+            readOnly = true;
+        }
+        readOnly = !!readOnly;
  
          if(this.rendered){
              this.eachItem(function(item){
@@ -430,7 +444,6 @@ Ext.form.CompositeField = Ext.extend(Ext.form.Field, {
      }
  });
  
-Ext.reg('compositefield', Ext.form.CompositeField);
-</pre>    
+Ext.reg('compositefield', Ext.form.CompositeField);</pre>    
  </body>
  </html>
 \ No newline at end of file