Changeset 2464

Timestamp:

05/27/2008 10:47:17 AM (5 months ago)

Author:

mikl

Message:

Added Prado.Validation.validateControl(id) on client side

Location:

trunk

Files:

• HISTORY (modified) (1 diff)
• framework/Web/Javascripts/source/prado/validator/validation3.js (modified) (8 diffs)

trunk/HISTORY

@@ -6 +6 @@
 BUG: Ticket#843 - TDataList alternatinItem issue after changes in rev 2227 (Christophe)
 BUG: Ticket#849 - TDatePicker selecting current date problem (Christophe)
+ENH: Added Prado.Validation.validateControl(id) on client side to validate a specific control (Michael)
 
 Version 3.1.2 April 21, 2008

trunk/framework/Web/Javascripts/source/prado/validator/validation3.js

@@ -72 +72 @@
  * <tt>groupID</tt> if present will only validate the validators
  * in a particular group.</p>
+ * <p>Use <code>{@link Prado.Validation.validateControl}(controlClientID)</code>
+ * to trigger validation for a single control.</p>
  * 
  * @object {static} Prado.Validation
@@ -106 +108 @@
                 }
         },
+
+        /**
+         * Validate all validators of a specific control.
+         * @function {boolean} ?
+         * @param {string} id - ID of DOM element to validate 
+         * @return true if all validators are valid or no validators present, false otherwise.
+         */
+    validateControl : function(id) 
+    {
+        var formId=this.getForm();
+
+                if (this.managers[formId])
+        {
+            return this.managers[formId].validateControl(id);
+        } else {
+                        throw new Error("A validation manager needs to be created first.");
+        }
+    },
 
         /**
@@ -209 +229 @@
 Prado.ValidationManager.prototype =
 {
+        /**
+         * Hash of registered validators by control's clientID
+         * @var controls
+         */
+    controls: {},
+
         /**
          * Initialize ValidationManager.
@@ -285 +311 @@
 
         /**
+         * Perform validation for all validators of a single control.
+         * @function {boolean} ?
+         * @param {string} id - ID of DOM element to validate 
+         * @return true if all validators are valid or no validators present, false otherwise.
+         */
+    validateControl : function (id) 
+    {
+        return this.controls[id] ? this.controls[id].invoke('validate',null).all() : true;
+    },
+
+        /**
          * Focus on the first validator that is invalid and options.FocusOnError is true.
          * @function ?
@@ -372 +409 @@
         addValidator : function(validator)
         {
-                // Erase any existing validator with same options
-                this.validators = this.validators.reject(function(v)
-                {
-                        return (v.options.ID==validator.options.ID);
-                });
+                // Remove previously registered validator with same ID
+        // to prevent stale validators created by AJAX updates
+        this.removeValidator(validator);
+
                 this.validators.push(validator);
                 if(validator.group && !this.groups.include(validator.group))
                         this.groups.push(validator.group);
+
+        if (typeof this.controls[validator.control.id] === 'undefined')
+            this.controls[validator.control.id] = Array();
+        this.controls[validator.control.id].push(validator);
         },
 
@@ -391 +431 @@
                 this.summaries.push(summary);
         },
+
+        /**
+         * Remove a validator from this manager
+         * @function ?
+         * @param {TBaseValidator} validator - Validator object
+         */
+    removeValidator : function(validator)
+    {
+                this.validators = this.validators.reject(function(v)
+                {
+                        return (v.options.ID==validator.options.ID);
+                });
+        if (this.controls[validator.control.id])
+            this.controls[validator.control.id].reject( function(v)
+            {
+                return (v.options.ID==validator.options.ID)
+            });
+    },
 
         /**
@@ -474 +532 @@
         {
                 /**
-                 * ValidationManager options
+                 * Validator options
                  * @var {object} options 
                  */
@@ -706 +764 @@
          * @constructor {protected} ?
          * @param {object} options - Options for initialization.
-         * @... {string} ID - ID of validation summary element.
+         * @... {string} ID - ID of validator
          * @... {string} FormID - ID of form of this manager.
          * @... {string} ControlToValidate - ID of control to validate.