form. validator.js

Tests a field against the validator’s rule(s).

Arguments

Returns

Retrieves the error message for the validator.

Arguments

Returns

The error message or the boolean false if no message is meant to be returned.

Removes all the error messages from the form.

Validates all the inputs in the form; note that this function is called on submit unless you specify otherwise in the options.

Validates the value of a field against all the validators.

Arguments

Tests a field against a specific validator.

Arguments

Removes all the error messages for a specific field.

Arguments

Stops validating the form; form will submit even if there are values that do not pass validation;

Resumes validating the form.

Stops validating a particular field.

Arguments

Resumes validating a particular field

Arguments

An array of <Validator> objects.

Adds a new form validator to the FormValidator object.

Arguments

Note

This method is a property of every instance of FormValidator as well as the FormValidator object itself.  That is to say that you can add validators to the FormValidator object or to an instance of it.  Adding validators to an instance of FormValidator will make those validators apply only to that instance, while adding them to the Class will make them available to all instances.

Examples

//add a validator for ALL instances
FormValidator.add('isEmpty', {
    errorMsg: 'This field is required',
    test: function(element){
        if(element.value.length ==0) return false;
        else return true;
    }
});

//this validator is only available to this single instance
var myFormValidatorInstance = new FormValidator('myform');
myFormValidatorInstance.add('doesNotContainTheLetterQ', {
    errorMsg: 'This field cannot contain the letter Q!',
    test: function(element){
        return !element.getValue().test('q','i');
    }
});

//Extend FormValidator, add a global validator for all instances of that version
var NewFormValidator = FormValidator.extend({
    //...some code
});
NewFormValidator.add('doesNotContainTheLetterZ', {
    errorMsg: 'This field cannot contain the letter Z!',
    test: function(element){
        return !element.getValue().test('z','i');
    }
});

An array of InputValidator configurations (see FormValidator.add above).

Example

FormValidator.addAllThese([
    ['className1', {errorMsg: ..., test: ...}],
    ['className2', {errorMsg: ..., test: ...}],
    ['className3', {errorMsg: ..., test: ...}],
]);

Evalutes if the input is empty; this is a utility validator, see <FormValidator.required>.

Displays an error if the field is empty.

Displays a message if the input value is less than the supplied length.

Note

You must add this className AND properties for it to your input.

Example

<input type="text" name="username" class="minLength props{minLength:10}" id="username">

Displays a message if the input value is less than the supplied length.

Note

You must add this className AND properties for it to your input.

Example

<input type="text" name="username" class="maxLength props{maxLength:100}" id="username">

Validates that the entry is a number.

Validates that the entry contains only numbers

Validates that the entry contains only letters

Validates that the entry is letters and numbers only

Validates that the entry parses to a date.

Validates that the entry is a valid email address.

Validates that the entry is a valid url

Validates that the entry matches dd/mm/yyyy.

Validates that the entry matches any of the following

• [$]1[##][,###]+[.##]
• [$]1###+[.##]
• [$]0.##
• [$].##

Validates that all the entries within the same node are not empty.

Note

This validator will get the parent element for the input and then check all its children.  To use this validator, enclose all the inputs you want to group in another element (doesn’t matter which); you only need apply this class to one of the elements.

Example

<div>
    <input ....>
    <input ....>
    <input .... className="validate-one-required">
</div>(end)