jQuery iMask Plugin

A jQuery input masking plugin.

Including

Include either jquery-imask.js or jquery-imask-min.js from the dist directory

Demos

http://cwolves.github.com/jQuery-iMask/

Example

$('#input').iMask({type : 'number'});$('#input').iMask({type : 'fixed',mask : '99/99/99'})

Options

type (number|fixed)
mask Mask using 9,a,x notation. 9=Numeric; a=Alpha; x=AlphaNumeric
maskEmptyChr [ Default = ' ' ]
validNumbers [ Default = '1234567890' ]
validAlphas [ Default = 'abcdefghijklmnopqrstuvwxyz' ]
validAlphaNums [ Default = 'abcdefghijklmnopqrstuvwxyz1234567890' ]
groupDigits [ Default = 3 ] # of digits before a numeric seperator ( e.g. "3" yields 1,000,000 )
decDigits [ Default = 2 ] # of digits to show after decimal place
currencySymbol
groupSymbol [ Default = ',' ]
decSymbol [ Default = '.' ]
showMask [ Default = true ] Show mask while editing
stripMask [ Default = false ] Remove mask when done editing
sanity Provide a function that acts as a sanity check.
return `false` to prevent the keypress, return any other value to replace the pre-masked input value.
number Override options for when validating numbers only
number.stripMask [ Default = false ]
number.showMask [ Default = false ]

Events

onValid
onInvalid

Features

• Static Masking
  • Mask numbers, letters
  • Customize list of valid numbers & letters
  • Special symbols are displayed but un-selectable
  • Optionally only show the mask while user is entering
• Numeric Masking
  • Control currency symbol, decimal & thousands seperator, # of digits
• Events
  • onValid
  • onInvalid

Browser Compatibility

iMask is tested in Chrome, Firefox, Safari & IE. It should work in any browser. If there are any issues, please report them.

The core code for the iMask plugin was originally created for MooTools by Fabio Zendhi Nagao (http://zendold.lojcomm.com.br/imask/)