@@ -1,3 +1,5 @@ +meioMask - a jQuery plugin for masking text inputs. + Created by Fabio M. Costa on 2008-09-16. Please report any bug at http://www.meiocodigo.com Copyright (c) 2008 Fabio M. Costa http://www.meiocodigo.com @@ -23,3 +25,35 @@ 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. + +# Changelog: +## 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. README @@ -1,4 +1,13 @@ TODO FEATURES: + +1.1.1 Bugs: +* A bug that has never been fixed (because i forgot) came to me right now... The last character from a mask can't be a fixed one or it will not be displayed.... Sux to be me... i'll have to fix it. +* defaultValue is not set and should be, on initialization, so the reset button works properly; +* Next form element should be visible. (offsetWidth ad height > 0); +* âêô are not in the @ rule; OK! +* set the size of the input, as an option. + + * allow a default value to be at the input if you try to delete everything; OK! * a callback should be called when you input something that is incorrect, something is correct and the mask is full; OK! * make a function that will mask a string just like it does with the inputs; OK! docs/todo.txt @@ -45,7 +45,7 @@ 'Z': /[A-Z]/, 'a': /[a-zA-Z]/, '*': /[0-9a-zA-Z]/, - '@': /[0-9a-zA-ZçÇáàãéèíìóòõúùü]/ + '@': /[0-9a-zA-ZçÇáàãéèíìóòõúùüê]/ }, // these keys will be ignored by the mask. @@ -263,8 +263,8 @@ case 'object': o = options; } + if(!o.fixedChars) o.fixedChars = this.options.fixedChars; - var fixedCharsReg = new RegExp(o.fixedChars), fixedCharsRegG = new RegExp(o.fixedChars, 'g'); @@ -670,4 +670,5 @@ } }); })(jQuery); - \ No newline at end of file + + jquery.meio.mask.js @@ -45,7 +45,7 @@ 'Z': /[A-Z]/, 'a': /[a-zA-Z]/, '*': /[0-9a-zA-Z]/, - '@': /[0-9a-zA-ZçÇáàãéèíìóòõúùü]/ + '@': /[0-9a-zA-ZçÇáàãâéèêíìóòôõúùü]/ }, // these keys will be ignored by the mask. @@ -214,12 +214,12 @@ $this.removeAttr(mlStr); // setting the input events - $this.bind('keydown', {func:maskObj._keyDown, thisObj:maskObj}, maskObj._onMask) - .bind('keypress', {func:maskObj._keyPress, thisObj:maskObj}, maskObj._onMask) - .bind('keyup', {func:maskObj._keyUp, thisObj:maskObj}, maskObj._onMask) - .bind('focus', maskObj._onFocus) - .bind('blur', maskObj._onBlur) - .bind('change', maskObj._onChange) + $this.bind('keydown.mask', {func:maskObj._keyDown, thisObj:maskObj}, maskObj._onMask) + .bind('keypress.mask', {func:maskObj._keyPress, thisObj:maskObj}, maskObj._onMask) + .bind('keyup.mask', {func:maskObj._keyUp, thisObj:maskObj}, maskObj._onMask) + .bind('focus.mask', maskObj._onFocus) + .bind('blur.mask', maskObj._onBlur) + .bind('change.mask', maskObj._onChange) .bind(pasteEvent, {func:maskObj._paste, thisObj:maskObj}, maskObj._delayedOnMask); } }); @@ -237,13 +237,7 @@ if(maxLength != -1) $this.attr('maxLength', maxLength); - $this.unbind('keydown', _this._onMask) - .unbind('keypress', _this._onMask) - .unbind('keyup', _this._onMask) - .unbind('focus', _this._onFocus) - .unbind('blur', _this._onBlur) - .unbind('change', _this._onChange) - .unbind(pasteEvent, _this._delayedOnMask) + $this.unbind('.mask') .removeData('mask'); } }); @@ -509,7 +503,7 @@ // browsers like firefox2 and before and opera doenst have the onPaste event, but the paste feature can be done with the onInput event. __getPasteEvent : function(){ - return ($.browser.opera || ($.browser.mozilla && parseFloat($.browser.version.substr(0,3)) < 1.9 ))?'input':'paste'; + return (($.browser.opera || ($.browser.mozilla && parseFloat($.browser.version.substr(0,3)) < 1.9 ))?'input':'paste') + '.mask'; }, __getKeyNumber : function(e){ source/jquery.meio.mask.js @@ -31,11 +31,15 @@ <script type="text/javascript" > (function($){ - $( - function(){ - $('input:text').setMask(); - } - ); + /*$.mask.rules = $.extend($.mask.rules, { + "~": /[+-]/, + "&": /[de]/, + "9": /[0-9]/ + });*/ + //$.mask.masks.ar = {mask: "aaa ~9,9& = ~9,9aaa 999º", fixedChars: '[,.= º]'}; + $(function(){ + $('input:text').setMask('ar'); + }); })(jQuery); </script> </head> @@ -58,9 +62,9 @@ </ul> <script type="text/javascript"> - (function($) { - $.mask.masks.msk = {mask: '999'}; - })(jQuery); + //(function($) { + // $.mask.masks.msk = {mask: '999'}; + //})(jQuery); </script> <form action="index_submit" method="get"> @@ -92,11 +96,11 @@ <input type="text" id="decimal_data-mask" name="some_name" value="12345" data-mask="decimal" /> <script type="text/javascript"> - (function($) { + /*(function($) { $(function(){ $('#decimal_data-mask').setMask({'attr': 'data-mask'}); }); - })(jQuery); + })(jQuery);*/ </script> </fieldset> @@ -160,7 +164,7 @@ <li><a id="lmask_string4" href="#">Mask input value to 'signed-decimal'</a></li> </ul> <script type="text/javascript"> - (function($) { + /*(function($) { $('#lmask_string1').click(function(){ $('#masked_string').text( 'Masked value: "'+$.mask.string( $('#dumb_input').val(), '99/99/99' )+'"' ); return false; @@ -177,7 +181,7 @@ $('#masked_string').text( 'Masked value: "'+$.mask.string( $('#dumb_input').val(), 'signed-decimal' )+'"' ); return false; }); - })(jQuery); + })(jQuery);*/ </script> </fieldset> </form> @@ -221,7 +225,7 @@ </div> <script type="text/javascript"> - $('#cb_test_input').setMask({mask:'99.99-99/99', defaultValue: '000', + /*$('#cb_test_input').setMask({mask:'99.99-99/99', defaultValue: '000', onInvalid:function(c,nKey){ $('#cb_alerts').text('You can\'t input "'+c+'" in here. It\'s keynumber is "'+nKey+'".'); $(this).css('background','red'); @@ -234,7 +238,7 @@ $('#cb_alerts').text("You can't enter more characters but your input might be ok!"); $(this).css('background','green'); } - }); + });*/ </script> </body> tests/visual-tests.php c3dc273ef7431a8d7e773b535b45bd0957ee2e53 Fábio M. Costa fabio@meiocodigo.com http://github.com/fabiomcosta/jquery-meiomask/commit/e68fddf35606563077b3b5af124f8232d0d2c476 e68fddf35606563077b3b5af124f8232d0d2c476 2009-06-25T17:03:36-07:00 2009-06-25T17:03:36-07:00 Little change on docs, added âêô to the @ rule. I'll release 1.1.2 for sure, dont know when. a3c0a5dcabfd0fe2d58e8a2afb5490c0cb0774f1 Fábio M. Costa fabio@meiocodigo.com