summaryrefslogtreecommitdiff
path: root/includes/js/dojox/validate/check.js
diff options
context:
space:
mode:
Diffstat (limited to 'includes/js/dojox/validate/check.js')
-rw-r--r--includes/js/dojox/validate/check.js261
1 files changed, 261 insertions, 0 deletions
diff --git a/includes/js/dojox/validate/check.js b/includes/js/dojox/validate/check.js
new file mode 100644
index 0000000..015da79
--- /dev/null
+++ b/includes/js/dojox/validate/check.js
@@ -0,0 +1,261 @@
+if(!dojo._hasResource["dojox.validate.check"]){ //_hasResource checks added by build. Do not use _hasResource directly in your code.
+dojo._hasResource["dojox.validate.check"] = true;
+dojo.provide("dojox.validate.check");
+
+dojo.require("dojox.validate._base");
+
+dojox.validate.check = function(/*HTMLFormElement*/form, /*Object*/profile){
+ // summary: validates user input of an HTML form based on input profile
+ //
+ // description:
+ // returns an object that contains several methods summarizing the results of the validation
+ //
+ // form: form to be validated
+ // profile: specifies how the form fields are to be validated
+ // {trim:Array, uppercase:Array, lowercase:Array, ucfirst:Array, digit:Array,
+ // required:Array, dependencies:Object, constraints:Object, confirm:Object}
+
+ // Essentially private properties of results object
+ var missing = [];
+ var invalid = [];
+
+ // results object summarizes the validation
+ var results = {
+ isSuccessful: function() {return ( !this.hasInvalid() && !this.hasMissing() );},
+ hasMissing: function() {return ( missing.length > 0 );},
+ getMissing: function() {return missing;},
+ isMissing: function(elemname) {
+ for(var i = 0; i < missing.length; i++){
+ if(elemname == missing[i]){ return true; }
+ }
+ return false;
+ },
+ hasInvalid: function() {return ( invalid.length > 0 );},
+ getInvalid: function() {return invalid;},
+ isInvalid: function(elemname){
+ for(var i = 0; i < invalid.length; i++){
+ if(elemname == invalid[i]){ return true; }
+ }
+ return false;
+ }
+ };
+
+ var _undef = function(name,object){
+ return (typeof object[name] == "undefined");
+ };
+
+ // Filters are applied before fields are validated.
+ // Trim removes white space at the front and end of the fields.
+ if(profile.trim instanceof Array){
+ for(var i = 0; i < profile.trim.length; i++){
+ var elem = form[profile.trim[i]];
+ if(_undef("type", elem) || elem.type != "text" && elem.type != "textarea" && elem.type != "password"){ continue; }
+ elem.value = elem.value.replace(/(^\s*|\s*$)/g, "");
+ }
+ }
+ // Convert to uppercase
+ if(profile.uppercase instanceof Array){
+ for(var i = 0; i < profile.uppercase.length; i++){
+ var elem = form[profile.uppercase[i]];
+ if(_undef("type", elem) || elem.type != "text" && elem.type != "textarea" && elem.type != "password"){ continue; }
+ elem.value = elem.value.toUpperCase();
+ }
+ }
+ // Convert to lowercase
+ if(profile.lowercase instanceof Array){
+ for (var i = 0; i < profile.lowercase.length; i++){
+ var elem = form[profile.lowercase[i]];
+ if(_undef("type", elem) || elem.type != "text" && elem.type != "textarea" && elem.type != "password"){ continue; }
+ elem.value = elem.value.toLowerCase();
+ }
+ }
+ // Uppercase first letter
+ if(profile.ucfirst instanceof Array){
+ for(var i = 0; i < profile.ucfirst.length; i++){
+ var elem = form[profile.ucfirst[i]];
+ if(_undef("type", elem) || elem.type != "text" && elem.type != "textarea" && elem.type != "password"){ continue; }
+ elem.value = elem.value.replace(/\b\w+\b/g, function(word) { return word.substring(0,1).toUpperCase() + word.substring(1).toLowerCase(); });
+ }
+ }
+ // Remove non digits characters from the input.
+ if(profile.digit instanceof Array){
+ for(var i = 0; i < profile.digit.length; i++){
+ var elem = form[profile.digit[i]];
+ if(_undef("type", elem) || elem.type != "text" && elem.type != "textarea" && elem.type != "password"){ continue; }
+ elem.value = elem.value.replace(/\D/g, "");
+ }
+ }
+
+ // See if required input fields have values missing.
+ if(profile.required instanceof Array){
+ for(var i = 0; i < profile.required.length; i++){
+ if(!dojo.isString(profile.required[i])){ continue; }
+ var elem = form[profile.required[i]];
+ // Are textbox, textarea, or password fields blank.
+ if(!_undef("type", elem)
+ && (elem.type == "text" || elem.type == "textarea" || elem.type == "password" || elem.type == "file")
+ && /^\s*$/.test(elem.value)){
+ missing[missing.length] = elem.name;
+ }
+ // Does drop-down box have option selected.
+ else if(!_undef("type", elem) && (elem.type == "select-one" || elem.type == "select-multiple")
+ && (elem.selectedIndex == -1
+ || /^\s*$/.test(elem.options[elem.selectedIndex].value))){
+ missing[missing.length] = elem.name;
+ }
+ // Does radio button group (or check box group) have option checked.
+ else if(elem instanceof Array){
+ var checked = false;
+ for(var j = 0; j < elem.length; j++){
+ if (elem[j].checked) { checked = true; }
+ }
+ if(!checked){
+ missing[missing.length] = elem[0].name;
+ }
+ }
+ }
+ }
+
+ // See if checkbox groups and select boxes have x number of required values.
+ if(profile.required instanceof Array){
+ for (var i = 0; i < profile.required.length; i++){
+ if(!dojo.isObject(profile.required[i])){ continue; }
+ var elem, numRequired;
+ for(var name in profile.required[i]){
+ elem = form[name];
+ numRequired = profile.required[i][name];
+ }
+ // case 1: elem is a check box group
+ if(elem instanceof Array){
+ var checked = 0;
+ for(var j = 0; j < elem.length; j++){
+ if(elem[j].checked){ checked++; }
+ }
+ if(checked < numRequired){
+ missing[missing.length] = elem[0].name;
+ }
+ }
+ // case 2: elem is a select box
+ else if(!_undef("type", elem) && elem.type == "select-multiple" ){
+ var selected = 0;
+ for(var j = 0; j < elem.options.length; j++){
+ if (elem.options[j].selected && !/^\s*$/.test(elem.options[j].value)) { selected++; }
+ }
+ if(selected < numRequired){
+ missing[missing.length] = elem.name;
+ }
+ }
+ }
+ }
+
+ // Dependent fields are required when the target field is present (not blank).
+ // Todo: Support dependent and target fields that are radio button groups, or select drop-down lists.
+ // Todo: Make the dependency based on a specific value of the target field.
+ // Todo: allow dependent fields to have several required values, like {checkboxgroup: 3}.
+ if(dojo.isObject(profile.dependencies)){
+ // properties of dependencies object are the names of dependent fields to be checked
+ for(name in profile.dependencies){
+ var elem = form[name]; // the dependent element
+ if(_undef("type", elem)){continue;}
+ if(elem.type != "text" && elem.type != "textarea" && elem.type != "password"){ continue; } // limited support
+ if(/\S+/.test(elem.value)){ continue; } // has a value already
+ if(results.isMissing(elem.name)){ continue; } // already listed as missing
+ var target = form[profile.dependencies[name]];
+ if(target.type != "text" && target.type != "textarea" && target.type != "password"){ continue; } // limited support
+ if(/^\s*$/.test(target.value)){ continue; } // skip if blank
+ missing[missing.length] = elem.name; // ok the dependent field is missing
+ }
+ }
+
+ // Find invalid input fields.
+ if(dojo.isObject(profile.constraints)){
+ // constraint properties are the names of fields to bevalidated
+ for(name in profile.constraints){
+ var elem = form[name];
+ if(!elem) {continue;}
+
+ // skip if blank - its optional unless required, in which case it
+ // is already listed as missing.
+ if(!_undef("tagName",elem)
+ && (elem.tagName.toLowerCase().indexOf("input") >= 0
+ || elem.tagName.toLowerCase().indexOf("textarea") >= 0)
+ && /^\s*$/.test(elem.value)){
+ continue;
+ }
+
+ var isValid = true;
+ // case 1: constraint value is validation function
+ if(dojo.isFunction(profile.constraints[name])){
+ isValid = profile.constraints[name](elem.value);
+ }else if(dojo.isArray(profile.constraints[name])){
+
+ // handle nested arrays for multiple constraints
+ if(dojo.isArray(profile.constraints[name][0])){
+ for (var i=0; i<profile.constraints[name].length; i++){
+ isValid = dojox.validate.evaluateConstraint(profile, profile.constraints[name][i], name, elem);
+ if(!isValid){ break; }
+ }
+ }else{
+ // case 2: constraint value is array, first elem is function,
+ // tail is parameters
+ isValid = dojox.validate.evaluateConstraint(profile, profile.constraints[name], name, elem);
+ }
+ }
+
+ if(!isValid){
+ invalid[invalid.length] = elem.name;
+ }
+ }
+ }
+
+ // Find unequal confirm fields and report them as Invalid.
+ if(dojo.isObject(profile.confirm)){
+ for(name in profile.confirm){
+ var elem = form[name]; // the confirm element
+ var target = form[profile.confirm[name]];
+ if (_undef("type", elem) || _undef("type", target) || (elem.type != "text" && elem.type != "textarea" && elem.type != "password")
+ ||(target.type != elem.type)
+ ||(target.value == elem.value) // it's valid
+ ||(results.isInvalid(elem.name))// already listed as invalid
+ ||(/^\s*$/.test(target.value))) // skip if blank - only confirm if target has a value
+ {
+ continue;
+ }
+ invalid[invalid.length] = elem.name;
+ }
+ }
+ return results; // Object
+};
+
+//TODO: evaluateConstraint doesn't use profile or fieldName args?
+dojox.validate.evaluateConstraint=function(profile, /*Array*/constraint, fieldName, elem){
+ // summary:
+ // Evaluates dojo.validate.check() constraints that are specified as array
+ // arguments
+ //
+ // description: The arrays are expected to be in the format of:
+ // constraints:{
+ // fieldName: [functionToCall, param1, param2, etc.],
+ // fieldName: [[functionToCallFirst, param1],[functionToCallSecond,param2]]
+ // }
+ //
+ // This function evaluates a single array function in the format of:
+ // [functionName, argument1, argument2, etc]
+ //
+ // The function will be parsed out and evaluated against the incoming parameters.
+ //
+ // profile: The dojo.validate.check() profile that this evaluation is against.
+ // constraint: The single [] array of function and arguments for the function.
+ // fieldName: The form dom name of the field being validated.
+ // elem: The form element field.
+
+ var isValidSomething = constraint[0];
+ var params = constraint.slice(1);
+ params.unshift(elem.value);
+ if(typeof isValidSomething != "undefined"){
+ return isValidSomething.apply(null, params);
+ }
+ return false; // Boolean
+}
+
+}