jQuery MeioMask

jQuery MeioMask - a jquery plugin for masking text inputs.

Maintainer

Dependencies

The only dependency is jQuery itself.

How to use

<html>
    <head>
        <script src="jquery-1.7.2.js"></script>
        <script src="jquery.meio.mask.min.js"></script>
    </head>

    <body>
        <form>
            <label for="time">Time Mask:</label>
            <input type="text" id="time" name="time" data-mask="time" />
        </form>

        <script>
            $('input[data-mask]').each(function() {
                var input = $(this);
                input.setMask(input.data('mask'));
            });
        </script>
    </body>
</html>

Documentation

http://www.meiocodigo.com/projects/meiomask/

Demos

You can see some demos inside the documentation at http://www.meiocodigo.com/projects/meiomask/#mm_demos and can play with them on the tests/visual-tests.html file.

Changelog

v1.1.11

continuous integration
automated testing
responsive visual tests

v1.1.10

Adding self to jQuery's plugin's repository http://plugins.jquery.com/

v1.1.8

Adding new callbacks onFocus and onBlur.

v1.1.7

Fixes errors related to $.browser, that was removed from jQuery.

v1.1.6

Doesn't throw errors while using autoTab on an input that has no parent form. fabiomcosta#8
Does not jump the carret to the end of the input while trying to change the current text on an input with the 'repeat' mask. fabiomcosta#14

v1.1.5

Fixes bug while being used on mobile.
Fixes bug on repeat mask. All chars were being added to the end of the input.

v1.1.4

Some internal better organization
Fixes bug on paste on IE7 while trying to paste from the mouse contextual menu

v1.1.1

Fixed caret bug on 'repeat' masks;
Fixed keyup event on fixed masks, it is now firing propertly;
Added selectCharsOnFocus option;
Added textAlign option.

v1.1

Mask type 'infinite' is now called 'repeat' (using 'infinite' still works but it is deprecated). It now allows a maxLenght value to be set. MaxLength can be setted by the maxLength attribute or the maxLength option;
You can easily set an auto-tab option that will focus the next form element when the masked input is totaly filled. It is true by default but you can put a jQuery selector string to match the next element you want to be focused.
Deprecated 'unmaskVal' function. This function is too buggy... works for most cases but not all. The best way to unmask a value is by doing it yourself;
'phone-us' mask is now '(999) 999-9999';
Correctly fires the onChange event on reverse masked inputs.

v1.0.4

New mask type 'infinite', it allows infinite values at masks. See demos for a better understanding;
Added new function 'unmaskVal' that returns the input value without the mask. See demos for a better understanding;
Removed a serious bug at IE that was fixing the caret at the end of the input;

v1.0.3

Callback functions now receive the char number as it second parameter, so it is possible to detect exactly which key has been pressed;
Added the signed masks. It only works with the reverse mask. See demos for more details;
iPhone support improved. iPhone now works 100% better than the 1.0.2 version. I'ts logic have been changed, and now it's working with full features. :P

v1.0.2

Added input callbacks: onInvalid, onValid and onOverflow;
Added support for default values;
Can now be used like $().setMask({});
Added the function $.mask.string(string,mask) that will mask a string (see demos);
Now the value of the input is masked at the time the mask is applyed to it.

v1.0.1

Added support for iphone;
Removed a bug where a fixed char would be replaced by an inputed one.

v1.0

initial release.

Contributing

Some details on how to contribute and stuff for maintainers of the project.

Release process

Very simple:

After doing your changes on the assets/javascripts/ files run rake test and rake build the root files jquery.meio.mask.js and jquery.meio.mask.min.js are going to be update.
Update the README.md file with the new version number and it's list of changes. A list of changes can be easily generated from the url https://github.com/fabiomcosta/jquery-meiomask/compare/...master
create a git tag: git tag <version>
push the new version with the new created tag: git push --tags

License

The MIT License (http://www.opensource.org/licenses/mit-license.php)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

danilo-teixeira / jquery-meiomask Goto Github PK

jquery-meiomask's Introduction