Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →

jquery-maskmoney

Package Overview

Dependencies

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

jquery-maskmoney

jQuery plugin to mask data entry in the input text in the form of money (currency)

3.0.2
latest
npm

Version published: 11 years ago

Maintainers: 1

Created: 11 years ago

Source

jQuery maskMoney

Just a simple way to create masks to your currency form fields with jQuery.

Download

To get the latest(minified) version, click here.

You can also use CloudFlare's cdnjs. Just choose the version you want to use here.

Show Time!

To view a complete demonstration of it's features and usage, access our examples page!

Usage:

<head>
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js" type="text/javascript"></script>
  <script src="dist/jquery.maskMoney.min.js" type="text/javascript"></script>
</head>
<body>
  <input type="text" id="currency" />
</body>
<script>
  $(function() {
    $('#currency').maskMoney();
  })
</script>

Options:

The options that you can set are:

prefix: the prefix to be displayed before(aha!) the value entered by the user(example: "US$ 1234.23"). default: ''
suffix: the prefix to be displayed after the value entered by the user(example: "1234.23 €"). default: ''
affixesStay: set if the prefix and suffix will stay in the field's value after the user exits the field. default: true
thousands: the thousands separator. default: ','
decimal: the decimal separator. default: '.'
precision: how many decimal places are allowed. default: 2
allowZero: use this setting to prevent users from inputing zero. default: false
allowNegative: use this setting to prevent users from inputing negative values. default: false

IMPORTANT: if you try to bind maskMoney to a read only field, nothing will happen, since we ignore completely read only fields. So, if you have a read only field, try to bind maskMoney to it, it will not work. Even if you change the field removing the readonly property, you will need to re-bind maskMoney to make it work.

Bonus!

We have 3 bonus methods that can be useful to you:

.maskMoney('destroy') removes maskMoney from an element.
.maskMoney('mask') apply the mask to your input. This method can work as a setter as well, if you pass a value to it, like this .maskMoney('mask', 1999.99)
.maskMoney('unmasked') return a float value (ex.: 'R$ 1.234,56' => 1234.56). PS: If you have only one input field, you should use this way .maskMoney('unmasked')[0], since it will always return an array.

You can also configure maskMoney options using the data-* API instead of passing it as a hash in the .maskMoney method call. To use it, simply set the options using data-<option>, like this:

	<input type="text" data-symbol="R$ " data-thousands="." data-decimal="," />

And when you bind maskMoney to that field, we will read those options.

Contributors:

License:

jQuery-maskMoney is released under the MIT license.

FAQs

What is jquery-maskmoney?

Is jquery-maskmoney well maintained?

Package last updated on 18 Jan 2014

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

jquery-maskmoney

Download

Show Time!

Usage:

Options:

Bonus!

Contributors:

License:

Related posts

Typosquatting Cryptographic Libraries: Malicious npm Packages Threaten Crypto Developers with Keylogging and Wallet Theft

Weekly Downloads Now Available in npm Package Search Results