/jQuery-iMask

Masking plugin for jQuery

Primary LanguageJavaScript

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/)