ng-form-group
v1.4.2
Published
Automatic Bootstrap validation based on ngModel
Downloads
1,524
Readme
ngFormGroup
ngFormGroup
applies Bootstrap validation classes based on ngModel
's validity.
Installation
In your Angular project, run npm install --save ng-form-group
if you're
using npm, or bower install --save ng-form-group
to save the module.
Then, in your HTML, add:
<script src="/path/to/assets/ng-form-group/index.min.js"></script>
And lastly, in your Angular module, include ng-form-group
as a dependency:
angular.module('my-app', ['ng-form-group')
Usage
Just mark up your form as recommended by Bootstrap
and any fields with the class form-group
will be automatically validated!
<form role="form">
<div class="form-group">
<label for="myEmail">Email address</label>
<input type="email" ng-model="myEmailModel" class="form-control" id="myEmail">
</div>
</form>
Now, when your model is invalided, by someone entering an invalid email
address, the has-error
class will be added to your form-group.
If you want to disable feedback for a specific form, add the form-group-without-feedback
class to the form-group:
<form role="form">
<div class="form-group form-group-without-feedback">
<label for="search">Search for things:</label>
<input type="search" ng-model="searchQuery" class="form-control" id="search">
</div>
</form>
Bonus round: Feedback icons!
Just add the .has-feedback
class to your form group, and we'll automatically add bootstrap style Feedback
icons to your form fields.
Contributing
To get your dev environment up and running, run npm install
and bower install
to get the components we need.
Tests are run with npm run test
and you can build the minified source with
npm run build
.
Releases are built using npm run release:[type]
. So, to generate a new patch
release, run npm run release:patch
. This script will:
- Generate minified, concatenated JS files,
- Increment the version in
package.json
andbower.json
- Tag a new release