From 9868f4ec0609bcdf4684df97b8ada90b838807df Mon Sep 17 00:00:00 2001 From: mikl <> Date: Tue, 27 May 2008 15:47:17 +0000 Subject: Added Prado.Validation.validateControl(id) on client side --- .../source/prado/validator/validation3.js | 72 +++++++++++++++++++--- 1 file changed, 65 insertions(+), 7 deletions(-) (limited to 'framework') diff --git a/framework/Web/Javascripts/source/prado/validator/validation3.js b/framework/Web/Javascripts/source/prado/validator/validation3.js index 5f08b615..c9dba7a1 100644 --- a/framework/Web/Javascripts/source/prado/validator/validation3.js +++ b/framework/Web/Javascripts/source/prado/validator/validation3.js @@ -71,6 +71,8 @@ Prado.Validation = Class.create(); * where formID is the HTML form ID, and the optional * groupID if present will only validate the validators * in a particular group.

+ *

Use {@link Prado.Validation.validateControl}(controlClientID) + * to trigger validation for a single control.

* * @object {static} Prado.Validation */ @@ -106,6 +108,24 @@ Object.extend(Prado.Validation, } }, + /** + * 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."); + } + }, + /** * Return first registered form * @function {string} ? @@ -208,6 +228,12 @@ Object.extend(Prado.Validation, Prado.ValidationManager = Class.create(); Prado.ValidationManager.prototype = { + /** + * Hash of registered validators by control's clientID + * @var controls + */ + controls: {}, + /** * Initialize ValidationManager. * @constructor {protected} ? @@ -283,6 +309,17 @@ Prado.ValidationManager.prototype = return valid; }, + /** + * 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 ? @@ -371,14 +408,17 @@ Prado.ValidationManager.prototype = */ 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,6 +431,24 @@ Prado.ValidationManager.prototype = 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) + }); + }, + /** * Gets validators with errors. * If group is set, only validators in that group are returned. @@ -473,7 +531,7 @@ Prado.WebUI.TValidationSummary.prototype = initialize : function(options) { /** - * ValidationManager options + * Validator options * @var {object} options */ this.options = options; @@ -705,7 +763,7 @@ Prado.WebUI.TBaseValidator.prototype = * Initialize TBaseValidator. * @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. * @... {optional string} InitialValue - Initial value of control to validate. -- cgit v1.2.3