bootstrap-validator

Validator, for Bootstrap 3

The Validator plugin offers automatic form validation configurable via mostly HTML5 standard attributes. It also provides an unobtrusive user experience, because nobody likes a naggy form.

Features

• Configurable via data-api and standard HTML5 attributes
• Patient to inform user of errors and eager to let them know the errors have been resolved
• Submit is disabled until the form is valid and all required fields are complete
• Customizable error messages
• Custom validator functions
• Validation of an input field via AJAX

Documentation

See the project docs at http://1000hz.github.io/bootstrap-validator

Contributing

Found an issue?

Be sure to include a reproducible test case on JSbin with your report.

Submitting a pull request?

Fork this repo and create a new branch for your patch. Try to adhere to the code style of Bootstrap 3's JS as much as possible. Be sure to add any relevant unit tests. Make sure everything's still ok by running grunt test. Lastly, don't pollute your patch branch with any unrelated changes.

Author

Cina Saffary

• http://twitter.com/1000hz
• http://github.com/1000hz

Thanks to @mdo and @fat for Bootstrap. <3

Copyright and license

Copyright 2016 Cina Saffary under the MIT license.

Changelog

0.11.0

BREAKING CHANGES:

• Custom validators are now expected to return an error string if the field is invalid.
• The errors option has been removed. Override $.fn.validator.Constructor.DEFAULTS.errors if you want to change the default match and minlength errors.
• The validator no longer skips disabled/invisible fields. If you want this behavior back, add $.fn.validator.Constructor.INPUT_SELECTOR += ':enabled:visible' to your code. (#115) (#134) (#317)

Enhancements:

• Added support for distinct custom errors for the standard HTML5 attribute validators. No more being stuck with data-native-error="" for all of them. (#222) (#241) (#285)
• Added a .validator('update') method to refresh the set of fields that will be validated (#306)
• Added support of data-validate="true|false" on inputs to force validation of that field
• Immediately validating fields that already have a value upon validator initialization (#350)

Bugfixes:

• Fixed a bug in Safari where element.checkValidity() was returning stale values (#293)
• Fixed a bug where spaces at the end of inputs were being trimmed off before being run through validators (#338)
• Custom validators no longer leak to other instances of Validator. (#176)
• Scrolling with focus: true option is now triggered on $('html, body') instead of $(document.body) for better cross-browser support (#282)
• Removed (value == previousValue => skip) optimization. It was breaking the match validator and wasn't improving perf that much. (#316) (#340)
• Added $.fn.validator.Constructor.VERSION property for parity with core Bootstrap plugins

Docs Changes:

• Docs: Added an Overview section which calls out that whatever conventions apply to Bootstrap's core plugins also apply here
• Docs: Added a callout blurb about the standard attribute validators
• Docs: Added a "Validated fields" section to document the Validator.INPUT_SELECTOR field
• Docs: Removed $() from method headers, which was confusing some people (#202)