diff options
Diffstat (limited to 'js/dojo-1.6/dojox/validate/check.xd.js')
| -rw-r--r-- | js/dojo-1.6/dojox/validate/check.xd.js | 340 |
1 files changed, 340 insertions, 0 deletions
diff --git a/js/dojo-1.6/dojox/validate/check.xd.js b/js/dojo-1.6/dojox/validate/check.xd.js new file mode 100644 index 0000000..8752a0e --- /dev/null +++ b/js/dojo-1.6/dojox/validate/check.xd.js @@ -0,0 +1,340 @@ +/*
+ Copyright (c) 2004-2011, The Dojo Foundation All Rights Reserved.
+ Available via Academic Free License >= 2.1 OR the modified BSD license.
+ see: http://dojotoolkit.org/license for details
+*/
+
+
+dojo._xdResourceLoaded(function(dojo, dijit, dojox){
+return {depends: [["provide", "dojox.validate.check"],
+["require", "dojox.validate._base"]],
+defineResource: function(dojo, dijit, dojox){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.experimental
+dojo.require("dojox.validate._base");
+
+/**
+ FIXME: How much does this overlap with dojox.form.Manager and friends?
+
+ Procedural API Description
+
+ The main aim is to make input validation expressible in a simple format.
+ You define profiles which declare the required and optional fields and any constraints they might have.
+ The results are provided as an object that makes it easy to handle missing and invalid input.
+
+ Usage
+
+ var results = dojox.validate.check(form, profile);
+
+ Profile Object
+
+ var profile = {
+ // filters change the field value and are applied before validation.
+ trim: ["tx1", "tx2"],
+ uppercase: ["tx9"],
+ lowercase: ["tx5", "tx6", "tx7"],
+ ucfirst: ["tx10"],
+ digit: ["tx11"],
+
+ // required input fields that are blank will be reported missing.
+ // required radio button groups and drop-down lists with no selection will be reported missing.
+ // checkbox groups and selectboxes can be required to have more than one value selected.
+ // List required fields by name and use this notation to require more than one value: {checkboxgroup: 2}, {selectboxname: 3}.
+ required: ["tx7", "tx8", "pw1", "ta1", "rb1", "rb2", "cb3", "s1", {"doubledip":2}, {"tripledip":3}],
+
+ // dependant/conditional fields are required if the target field is present and not blank.
+ // At present only textbox, password, and textarea fields are supported.
+ dependencies: {
+ cc_exp: "cc_no",
+ cc_type: "cc_no"
+ },
+
+ // Fields can be validated using any boolean valued function.
+ // Use arrays to specify parameters in addition to the field value.
+ constraints: {
+ field_name1: myValidationFunction,
+ field_name2: dojox.validate.isInteger,
+ field_name3: [myValidationFunction, additional parameters],
+ field_name4: [dojox.validate.isValidDate, "YYYY.MM.DD"],
+ field_name5: [dojox.validate.isEmailAddress, false, true]
+ },
+
+ // Confirm is a sort of conditional validation.
+ // It associates each field in its property list with another field whose value should be equal.
+ // If the values are not equal, the field in the property list is reported as Invalid. Unless the target field is blank.
+ confirm: {
+ email_confirm: "email",
+ pw2: "pw1"
+ }
+ };
+
+ Results Object
+
+ isSuccessful(): Returns true if there were no invalid or missing fields, else it returns false.
+ hasMissing(): Returns true if the results contain any missing fields.
+ getMissing(): Returns a list of required fields that have values missing.
+ isMissing(field): Returns true if the field is required and the value is missing.
+ hasInvalid(): Returns true if the results contain fields with invalid data.
+ getInvalid(): Returns a list of fields that have invalid values.
+ isInvalid(field): Returns true if the field has an invalid value.
+
+*/
+
+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
+}
+
+}
+
+}};});
|