# ui-validate [](https://travis-ci.org/angular-ui/ui-validate) [](http://badge.fury.io/js/angular-ui-validate) [](http://badge.fury.io/bo/angular-ui-validate) [](https://gitter.im/angular-ui/ui-validate?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
General-purpose validator for ngModel.
Angular.js comes with several built-in validation mechanism for input fields (ngRequired, ngPattern etc.) but using
an arbitrary validation function requires creation of a custom formatters and / or parsers.
The ui-validate directive makes it easy to use any function(s) defined in scope as a validator function(s).
A validator function will trigger validation on both model and input changes.
## Requirements
- AngularJS
## Usage
You can get it from [Bower](http://bower.io/)
```sh
bower install angular-ui-validate
```
Load the script files in your application:
```html
```
Add the specific module to your dependencies:
```javascript
angular.module('myApp', ['ui.validate', ...])
```
Or using npm, webpack and es6 import
```sh
npm install --save angular-ui-validate
```
Don't add script tags in your html page. instead
```javascript
import uiValidate from 'angular-ui-validate'
angular.module('myApp', [uiValidate, ...])
```
## Development
We use Karma and jshint to ensure the quality of the code. The easiest way to run these checks is to use grunt:
```sh
npm install -g gulp-cli
npm install && bower install
gulp
```
The karma task will try to open Firefox and Chrome as browser in which to run the tests. Make sure this is available or change the configuration in `karma.conf.js`
### Gulp watch
`gulp watch` will automatically test your code and build a release whenever source files change.
### How to release
Use gulp to bump version, build and create a tag. Then push to GitHub:
````sh
gulp release [--patch|--minor|--major]
git push --tags origin master # push everything to GitHub
````
Travis will take care of testing and publishing to npm's registry (bower will pick up the change automatically). Finally [create a release on GitHub](https://github.com/angular-ui/ui-validate/releases/new) from the tag created by Travis.