PHPackages                             igorescobar/jquery-mask-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. igorescobar/jquery-mask-plugin

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

igorescobar/jquery-mask-plugin
==============================

A jQuery Plugin to make masks on form fields and html elements.

v1.14.1(10y ago)11258.2k—7.7%3MITJavaScript

Since Apr 27Pushed 10y ago1 watchersCompare

[ Source](https://github.com/kamihouse/jQuery-Mask-Plugin)[ Packagist](https://packagist.org/packages/igorescobar/jquery-mask-plugin)[ Docs](https://github.com/igorescobar/jQuery-Mask-Plugin)[ RSS](/packages/igorescobar-jquery-mask-plugin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (3)

\#jQuery Mask Plugin A jQuery Plugin to make masks on form fields and HTML elements.

[![Build Status](https://camo.githubusercontent.com/099c84e5ffb4d567d7a1cfdb71250b5ce96cae02f8c7915c84950174c531537f/68747470733a2f2f7472617669732d63692e6f72672f69676f726573636f6261722f6a51756572792d4d61736b2d506c7567696e2e706e67)](https://travis-ci.org/igorescobar/jQuery-Mask-Plugin)[![Code Climate](https://camo.githubusercontent.com/7cbcad4754eaddc2714ae44f79b3eb7934682a97afb45b43cac02ffd381b6587/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f69676f726573636f6261722f6a51756572792d4d61736b2d506c7567696e2e706e67)](https://codeclimate.com/github/igorescobar/jQuery-Mask-Plugin)

\#Documentation, Demos &amp; Usage Examples

\##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

[](#english)

- [Masks with jQuery Mask Plugin](http://bit.ly/masks-with-jquery-mask-plugin)
- [Using jQuery Mask Plugin With Zepto.js](http://bit.ly/using-jquery-mask-plugin-with-zeptojs)

### Portuguese

[](#portuguese)

- [Mascaras com JQuery Mask Plugin](http://bit.ly/mascaras-com-jquery-mask-plugin)
- [Mascara Javascript para os novos telefones de São Paulo](http://bit.ly/mascara-javascript-para-os-novos-telefones-de-sao-paulo)

### Russian

[](#russian)

- [jQuery Mask Plugin](http://zencoder.ru/javascript/jquery-mask-plugin/)

Compatibility
-------------

[](#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 &amp; Bugs?
--------------------

[](#problems--bugs)

Did you read our [docs](https://igorescobar.github.io/jQuery-Mask-Plugin/)? Yes? Cool! So now... make sure that you have a *functional* [jsfiddle](http://jsfiddle.net/) exemplifying your problem and open an [issue](https://github.com/igorescobar/jQuery-Mask-Plugin/issues) for us. Don't know how to do it? Use this [fiddle example](http://jsfiddle.net/igorescobar/6pco4om7/).

Contributing
------------

[](#contributing)

- **Bug Reporting**: Yes! You can contribute opening [issues](https://github.com/igorescobar/jQuery-Mask-Plugin/issues)!
- **Documenting**: Do you think that something in our [docs](https://github.com/igorescobar/jQuery-Mask-Plugin/tree/gh-pages) 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](https://github.com/igorescobar/jQuery-Mask-Plugin/tree/master/test) to make sure that everything are working propertly.
- **Improving**: Open an [issue](https://github.com/igorescobar/jQuery-Mask-Plugin/issues) 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

[](#unit-tests)

We use [QUnit](http://qunitjs.com/) and [GruntJS](http://gruntjs.com/). 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](https://www.docker.com/) 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
------------

[](#contributors)

- [Igor Lima](https://github.com/igorlima)
- [Mark Simmons](https://github.com/Markipelago)
- [Gabriel Schammah](https://github.com/gschammah)
- [Marcelo Manzan](https://github.com/kawamanza)
- [See the full list](https://github.com/igorescobar/jQuery-Mask-Plugin/graphs/contributors)

Help us!
--------

[](#help-us)

[![Click here to lend your support to: jQuery Mask Plugin and make a donation at pledgie.com !](https://camo.githubusercontent.com/4feaad404bffe21e81206221129a7e8cd572378f7cc1efe5aa688f89bcd874d4/68747470733a2f2f706c65646769652e636f6d2f63616d706169676e732f32323634392e706e673f736b696e5f6e616d653d6368726f6d65)](https://pledgie.com/campaigns/22649)

[![Flattr this](https://camo.githubusercontent.com/d72e55c5c5baef1656773d3bb52c77a2566196f35e85f394f3196e2f748d679e/68747470733a2f2f6170692e666c617474722e636f6d2f627574746f6e2f666c617474722d62616467652d6c617267652e706e67)](https://flattr.com/submit/auto?user_id=igorescobar&url=https%3A%2F%2Fflattr.com%2Fprofile%2Figorescobar)

Donators (Thanks!)
------------------

[](#donators-thanks)

- Rinaldo Morato
- [Marcelo Otowicz](http://www.ofen.com.br/)
- Marcia Cristina Cava
- [Igor Lima](https://github.com/igorlima)
- Steve Binder
- Douglas Patrocinio
- Paulo Diogo Rodrigues Leão
- Dorijan Covran
- Amaro Mariño Malvido
- Mark Guadagna
- Serdar Selim Tulunoğlu
- [Software Download](http://software-download.name)
- [Full list](https://pledgie.com/campaigns/22649#donors)

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity40

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor4

4 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3673d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3b25bb4e88449885be21286cb89ae72a9e9571cb54a4af592cc6fcc4f6c99c93?d=identicon)[kamihouse](/maintainers/kamihouse)

---

Top Contributors

[![lagden](https://avatars.githubusercontent.com/u/130963?v=4)](https://github.com/lagden "lagden (8 commits)")[![sonarsphere](https://avatars.githubusercontent.com/u/1579501?v=4)](https://github.com/sonarsphere "sonarsphere (7 commits)")[![kamihouse](https://avatars.githubusercontent.com/u/892340?v=4)](https://github.com/kamihouse "kamihouse (6 commits)")[![justLuiz](https://avatars.githubusercontent.com/u/1229702?v=4)](https://github.com/justLuiz "justLuiz (6 commits)")[![kassner](https://avatars.githubusercontent.com/u/301255?v=4)](https://github.com/kassner "kassner (3 commits)")[![igorlima](https://avatars.githubusercontent.com/u/1886786?v=4)](https://github.com/igorlima "igorlima (2 commits)")[![rdhammond](https://avatars.githubusercontent.com/u/801522?v=4)](https://github.com/rdhammond "rdhammond (2 commits)")[![nawarian](https://avatars.githubusercontent.com/u/3905582?v=4)](https://github.com/nawarian "nawarian (2 commits)")[![rafaelcanovas](https://avatars.githubusercontent.com/u/1323876?v=4)](https://github.com/rafaelcanovas "rafaelcanovas (2 commits)")[![Markipelago](https://avatars.githubusercontent.com/u/708457?v=4)](https://github.com/Markipelago "Markipelago (1 commits)")[![mrksmrtn](https://avatars.githubusercontent.com/u/539896?v=4)](https://github.com/mrksmrtn "mrksmrtn (1 commits)")[![natematykiewicz](https://avatars.githubusercontent.com/u/5104186?v=4)](https://github.com/natematykiewicz "natematykiewicz (1 commits)")[![schmidt](https://avatars.githubusercontent.com/u/734?v=4)](https://github.com/schmidt "schmidt (1 commits)")[![serGlazkov](https://avatars.githubusercontent.com/u/5631994?v=4)](https://github.com/serGlazkov "serGlazkov (1 commits)")[![Eliak](https://avatars.githubusercontent.com/u/3325838?v=4)](https://github.com/Eliak "Eliak (1 commits)")[![6uimorais](https://avatars.githubusercontent.com/u/1413429?v=4)](https://github.com/6uimorais "6uimorais (1 commits)")[![fdeslandes-wk](https://avatars.githubusercontent.com/u/18143635?v=4)](https://github.com/fdeslandes-wk "fdeslandes-wk (1 commits)")[![gschammah](https://avatars.githubusercontent.com/u/591992?v=4)](https://github.com/gschammah "gschammah (1 commits)")[![jairhenrique](https://avatars.githubusercontent.com/u/81854?v=4)](https://github.com/jairhenrique "jairhenrique (1 commits)")[![kawamanza](https://avatars.githubusercontent.com/u/201839?v=4)](https://github.com/kawamanza "kawamanza (1 commits)")

---

Tags

pluginjquerymask

### Embed Badge

![Health badge](/badges/igorescobar-jquery-mask-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/igorescobar-jquery-mask-plugin/health.svg)](https://phpackages.com/packages/igorescobar-jquery-mask-plugin)
```

###  Alternatives

[onokumus/metismenu

A jQuery menu plugin

2.0k263.3k5](/packages/onokumus-metismenu)[kartik-v/yii2-widget-datepicker

Enhanced Yii2 wrapper for the bootstrap datepicker plugin (sub repo split from yii2-widgets).

1097.0M60](/packages/kartik-v-yii2-widget-datepicker)[kartik-v/yii2-widget-depdrop

Widget that enables setting up dependent dropdowns with nested dependencies (sub repo split from yii2-widgets)

814.9M18](/packages/kartik-v-yii2-widget-depdrop)[kartik-v/yii2-widget-typeahead

Enhanced Yii2 wrapper for the Twitter Typeahead plugin (sub repo split from yii2-widgets).

454.8M9](/packages/kartik-v-yii2-widget-typeahead)[kartik-v/yii2-widget-rating

A Yii2 widget for the simple yet powerful bootstrap-star-rating plugin with fractional rating support (sub repo split from yii2-widgets)

444.1M8](/packages/kartik-v-yii2-widget-rating)[kartik-v/yii2-widget-colorinput

An enhanced Yii 2 widget encapsulating the HTML 5 color input (sub repo split from yii2-widgets)

324.8M10](/packages/kartik-v-yii2-widget-colorinput)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
