igorescobar / jquery-mask-plugin
A jQuery Plugin to make masks on form fields and html elements.
Installs: 200 017
Dependents: 4
Suggesters: 0
Security: 0
Stars: 10
Watchers: 2
Forks: 1 423
Language:JavaScript
This package is auto-updated.
Last update: 2024-10-13 02:38:19 UTC
README
#jQuery Mask Plugin A jQuery Plugin to make masks on form fields and HTML elements.
#Documentation, Demos & Usage Examples https://igorescobar.github.io/jQuery-Mask-Plugin/
##Features
- Lightweight (~2kb minified, ~1kb gziped).
- Built-in support for dynamically added elements.
- Masks on any HTML element (no need to server-side mask anymore!)!
- HTML notation support (data-mask, data-mask-recursive, data-mask-clearifnotmatch).
- String/Numeric/Alpha/Mixed masks.
- Reverse mask support for masks on numeric fields.
- Sanitization.
- Optional digits.
- Recursive Digits.
- Fallback Digits.
- Advanced mask initialization.
- Advanced Callbacks.
- On-the-fly mask change.
- Mask removal.
- Full customization.
- Compatibility with UMD/Zepto.js/Angular.JS.
- HTML5 placeholder support.
- Clear the field if it not matches support.
##Tutorials
English
Portuguese
Russian
Compatibility
jQuery Mask Plugin has been tested with jQuery 1.7+ on all major browsers:
- Firefox 2+ (Win, Mac, Linux);
- IE7+ (Win);
- Chrome 6+ (Win, Mac, Linux, Android, iPhone);
- Safari 3.2+ (Win, Mac, iPhone);
- Opera 8+ (Win, Mac, Linux, Android, iPhone).
Problems & Bugs?
Did you read our docs? Yes? Cool! So now... make sure that you have a functional jsfiddle exemplifying your problem and open an issue for us. Don't know how to do it? Use this fiddle example.
Contributing
- Bug Reporting: Yes! You can contribute opening issues!
- Documenting: Do you think that something in our docs should be better? Do you have a cool idea to increase the awesomeness? Summit your pull request with your idea!
- Bug Fixing: No time to lose? Fix it and help others! Write some tests to make sure that everything are working propertly.
- Improving: Open an issue and lets discuss it. Just to make sure that you're on the right track.
- Sharing: Yes! Have we saved some of your time? Are you enjoying our mask plugin? Sharing is caring! Tweet it! Facebook it! Linkedin It(?!) :D
- Donating: Hey, now that you don't need to worry about masks again... buy me a coffee, beer or a PlayStation 4 (Xbox One also accepted!) :o)
Unit Tests
We use QUnit and GruntJS. To run our test suit is just run: grunt test
in your console or you can open those test-for*.html
files inside of our test/
folder.
In case you're familiar with Docker here is how you can use it:
docker build -t jquery-mask . CONTAINER_ID=$(docker run -d -v $PWD:/app/jquery-mask-plugin jquery-mask) docker exec $CONTAINER_ID sh -c "npm install" docker exec -it $CONTAINER_ID /bin/bash grunt test
Contributors
Help us!
Donators (Thanks!)
- Rinaldo Morato
- Marcelo Otowicz
- Marcia Cristina Cava
- Igor Lima
- Steve Binder
- Douglas Patrocinio
- Paulo Diogo Rodrigues Leão
- Dorijan Covran
- Amaro Mariño Malvido
- Mark Guadagna
- Serdar Selim Tulunoğlu
- Software Download
- Full list