Giter Club home page Giter Club logo

approvejs's Introduction

ApproveJs

A simple validation library that doesn't interfere

release npm CDNJS Build Status downloads


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 handle validation how you want.

ApproveJs exposes a single method, value() and leaves you to decide when a value is validated and how errors are displayed.

Using ApproveJs, you can automate validation however you please.

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

Download Latest Release

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 approvejs

Add 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 approvejs

or if you're using Yarn

$ yarn add approvejs

Require 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);
});

View the project page for demos and documentation on rules and extending ApproveJs with your own tests.

If you would like to contribute to the project, please read contributing.

approvejs's People

Contributors

charlgottschalk avatar kaocy avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.