| Server IP : 104.21.32.1 / Your IP : 216.73.216.145 Web Server : LiteSpeed System : Linux premium151.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64 User : tempvsty ( 647) PHP Version : 8.0.30 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /proc/self/cwd/wp-content/plugins/motopress-content-editor/jquery/model/validations/ |
Upload File : |
steal('jquery/model').then(function($){
/**
@page jquery.model.validations Validations
@plugin jquery/model/validations
@download http://jmvcsite.heroku.com/pluginify?plugins[]=jquery/model/validations/validations.js
@test jquery/model/validations/qunit.html
@parent jQuery.Model
In many apps, it's important to validate data before sending it to the server.
The jquery/model/validations plugin provides validations on models.
## Example
To use validations, you need to call a validate method on the Model class.
The best place to do this is in a Class's init function.
@codestart
$.Model("Contact",{
init : function(){
// validates that birthday is in the future
this.validate("birthday",function(){
if(this.birthday > new Date){
return "your birthday needs to be in the past"
}
})
}
},{});
@codeend
## Demo
Click a person's name to update their birthday. If you put the date
in the future, say the year 2525, it will report back an error.
@demo jquery/model/validations/validations.html
*/
//validations object is by property. You can have validations that
//span properties, but this way we know which ones to run.
// proc should return true if there's an error or the error message
var validate = function(attrNames, options, proc) {
if(!proc){
proc = options;
options = {};
}
options = options || {};
attrNames = $.makeArray(attrNames)
if(options.testIf && !options.testIf.call(this)){
return;
}
var self = this;
$.each(attrNames, function(i, attrName) {
// Call the validate proc function in the instance context
if(!self.validations[attrName]){
self.validations[attrName] = [];
}
self.validations[attrName].push(function(){
var res = proc.call(this, this[attrName]);
return res === undefined ? undefined : (options.message || res);
})
});
};
$.extend($.Model, {
/**
* @function jQuery.Model.static.validate
* @parent jquery.model.validations
* Validates each of the specified attributes with the given function. See [jquery.model.validations validation] for more on validations.
* @param {Array|String} attrNames Attribute name(s) to to validate
* @param {Function} validateProc Function used to validate each given attribute. Returns nothing if valid and an error message otherwise. Function is called in the instance context and takes the value to validate.
* @param {Object} options (optional) Options for the validations. Valid options include 'message' and 'testIf'.
*/
validate: validate,
/**
* @attribute jQuery.Model.static.validationMessages
* @parent jquery.model.validations
* The default validation error messages that will be returned by the builtin
* validation methods. These can be overwritten by assigning new messages
* to $.Model.validationMessages.<message> in your application setup.
*
* The following messages (with defaults) are available:
*
* * format - "is invalid"
* * inclusion - "is not a valid option (perhaps out of range)"
* * lengthShort - "is too short"
* * lengthLong - "is too long"
* * presence - "can't be empty"
* * range - "is out of range"
*
* It is important to steal jquery/model/validations before
* overwriting the messages, otherwise the changes will
* be lost once steal loads it later.
*
* ## Example
*
* $.Model.validationMessages.format = "is invalid dummy!"
*/
validationMessages : {
format : "is invalid",
inclusion : "is not a valid option (perhaps out of range)",
lengthShort : "is too short",
lengthLong : "is too long",
presence : "can't be empty",
range : "is out of range"
},
/**
* @function jQuery.Model.static.validateFormatOf
* @parent jquery.model.validations
* Validates where the values of specified attributes are of the correct form by
* matching it against the regular expression provided. See [jquery.model.validations validation] for more on validations.
* @param {Array|String} attrNames Attribute name(s) to to validate
* @param {RegExp} regexp Regular expression used to match for validation
* @param {Object} options (optional) Options for the validations. Valid options include 'message' and 'testIf'.
*
*/
validateFormatOf: function(attrNames, regexp, options) {
validate.call(this, attrNames, options, function(value) {
if( (typeof value != 'undefined' && value != '')
&& String(value).match(regexp) == null )
{
return this.Class.validationMessages.format;
}
});
},
/**
* @function jQuery.Model.static.validateInclusionOf
* @parent jquery.model.validations
* Validates whether the values of the specified attributes are available in a particular
* array. See [jquery.model.validations validation] for more on validations.
* @param {Array|String} attrNames Attribute name(s) to to validate
* @param {Array} inArray Array of options to test for inclusion
* @param {Object} options (optional) Options for the validations. Valid options include 'message' and 'testIf'.
*
*/
validateInclusionOf: function(attrNames, inArray, options) {
validate.call(this, attrNames, options, function(value) {
if(typeof value == 'undefined')
return;
if($.grep(inArray, function(elm) { return (elm == value);}).length == 0)
return this.Class.validationMessages.inclusion;
});
},
/**
* @function jQuery.Model.static.validateLengthOf
* @parent jquery.model.validations
* Validates that the specified attributes' lengths are in the given range. See [jquery.model.validations validation] for more on validations.
* @param {Array|String} attrNames Attribute name(s) to to validate
* @param {Number} min Minimum length (inclusive)
* @param {Number} max Maximum length (inclusive)
* @param {Object} options (optional) Options for the validations. Valid options include 'message' and 'testIf'.
*
*/
validateLengthOf: function(attrNames, min, max, options) {
validate.call(this, attrNames, options, function(value) {
if((typeof value == 'undefined' && min > 0) || value.length < min)
return this.Class.validationMessages.lengthShort + " (min=" + min + ")";
else if(typeof value != 'undefined' && value.length > max)
return this.Class.validationMessages.lengthLong + " (max=" + max + ")";
});
},
/**
* @function jQuery.Model.static.validatePresenceOf
* @parent jquery.model.validations
* Validates that the specified attributes are not blank. See [jquery.model.validations validation] for more on validations.
* @param {Array|String} attrNames Attribute name(s) to to validate
* @param {Object} options (optional) Options for the validations. Valid options include 'message' and 'testIf'.
*
*/
validatePresenceOf: function(attrNames, options) {
validate.call(this, attrNames, options, function(value) {
if(typeof value == 'undefined' || value == "" || value === null)
return this.Class.validationMessages.presence;
});
},
/**
* @function jQuery.Model.static.validateRangeOf
* @parent jquery.model.validations
* Validates that the specified attributes are in the given numeric range. See [jquery.model.validations validation] for more on validations.
* @param {Array|String} attrNames Attribute name(s) to to validate
* @param {Number} low Minimum value (inclusive)
* @param {Number} hi Maximum value (inclusive)
* @param {Object} options (optional) Options for the validations. Valid options include 'message' and 'testIf'.
*
*/
validateRangeOf: function(attrNames, low, hi, options) {
validate.call(this, attrNames, options, function(value) {
if(typeof value != 'undefined' && value < low || value > hi)
return this.Class.validationMessages.range + " [" + low + "," + hi + "]";
});
}
});
});