approvejs
v3.1.2
Published
A simple JavaScript validation library that doesn't interfere.
Downloads
5,160
Maintainers
charlgottschalkReadme
ApproveJs
A simple validation library that doesn't interfere
ApproveJs doesn't automatically attach itself to input change events or form submit events. It also doesn't manipulate the DOM for you by automatically displaying errors. This allows you to automate validation how you want.
With a single method (approve.value()), you can decide how to handle validation.
If you like to be in control or have a little OCD like me, ApproveJs is for you.
ApproveJs is also easily extended with custom tests.
Installation
Standalone
Unzip master.zip into your desired folder and add a script tag to the library before the end of your closing <body> tag
<script src="path/to/approve.min.js"></script>Bower
In your terminal run:
$ bower install approvejsAdd a script tag to the library before the end of your closing <body> tag
<script src="path/to/bower_components/approvejs/dist/approve.min.js"></script>cdnjs
Add a script tag to the library CDN url before the end of your closing <body> tag
<script src="https://cdnjs.cloudflare.com/ajax/libs/approvejs/[version]/approve.min.js"></script>Get the cdn urls from here
Many thanks to cdnjs who kindly hosts ApproveJS through a reliable CDN
Node
In your terminal run:
$ npm install approvejsor if you're using Yarn
$ yarn add approvejsRequire approvejs.
var approve = require('approvejs');Usage
ApproveJS exposes a single method value that takes two parameters.
The first parameter is the value to validate and the second is the set of rules to test against.
var rules = {
required: true,
email: true
};
var result = approve.value('[email protected]', rules);The returned result contains two properties:
{
approved: boolean,
errors: []
}Accessing Errors
You can access errors returned by the result in one of two ways:
Errors Property
var i = result.errors.length;
while(i--) {
console.log(result.errors[i]);
}.each Method
The result object exposes an each() method for easily getting to errors.
result.each(function(error) {
console.log(error);
});Read documentation here.
If you would like to contribute to the project, please read contributing.