Changeset 14556

Timestamp:

07/22/08 11:25:37 (4 months ago)

Author:

bill

Message:

Add/fix comments, and simplify one block of code. Refs #5417 !strict.

Files:

• dijit/trunk/_Widget.js (modified) (4 diffs)

dijit/trunk/_Widget.js

@@ -221 +221 @@
                         delete this._deferredConnects[attr]; // can't be in both attributeMap and _deferredConnects
                 }
+                // If a subclass has redefined a callback (ex: onClick) then assume it's being
+                // attached to explicitly, via dojoAttachEvent="" (or attributeMap, but that was handled
+                // above) and ignore the entry in _deferredConnects
                 for(var attr in this._deferredConnects){
                         if(this[attr] !== dijit._connectOnUseEventHandler){
@@ -284 +287 @@
                 this.buildRendering();
 
-                // Copy attributes listed in attributeMap into the [newly created] DOM for the widget.
-                // The placement of these attributes is according to the property mapping in attributeMap.
-                // Note special handling for 'style' and 'class' attributes which are lists and can
-                // have elements from both old and new structures, and some attributes like "type"
-                // cannot be processed this way as they are not mutable.
                 if(this.domNode){
+                        // Copy attributes listed in attributeMap into the [newly created] DOM for the widget.
                         for(var attr in this.attributeMap){
                                 var value = this[attr];
@@ -296 +295 @@
                                 }
                         }
-                        for(var attr in this._deferredConnects){
-                                var value = this[attr];
-                                if(value !== dijit._connectOnUseEventHandler){
-                                        this._onConnect(attr);
-                                }
+
+                        // If the developer has specified a handler as a widget parameter
+                        // (ex: new Button({onClick: ...})
+                        // then naturally need to connect from dom node to that handler immediately, 
+                        for(var attr in this.params){
+                                this._onConnect(attr);
                         }
                 }
@@ -476 +476 @@
                 //              Set native HTML attributes reflected in the widget,
                 //              such as readOnly, disabled, and maxLength in TextBox widgets.
+                //              The placement of these attributes is according to the property mapping in attributeMap.
+                //
                 //      description:
-                //              In general, a widget's "value" is controlled via setValue()/getValue(), 
+                //              Note special handling for 'style' and 'class' attributes which are lists and can
+                //              have elements from both old and new structures, and some attributes like "type"
+                //              cannot be processed this way as they are not mutable.
+                //
+                //              Also, in general, a widget's "value" is controlled via setValue()/getValue(), 
                 //              rather than this method.  The exception is for widgets where the
                 //              end user can't adjust the value, such as Button and CheckBox;