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

• Masks with jQuery Mask Plugin
• Using jQuery Mask Plugin With Zepto.js

Portuguese

• Mascaras com JQuery Mask Plugin
• Mascara Javascript para os novos telefones de São Paulo

Russian

• jQuery Mask Plugin

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

• Igor Lima
• Mark Simmons
• Gabriel Schammah
• Marcelo Manzan
• See the full list

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