Skip to content

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

License

Notifications You must be signed in to change notification settings

tafs7/jquery-maskmoney

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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


Show Time!

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


Usage:

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

Options:

The options that you can set are:

  • symbol: the symbol to be displayed before the value entered by the user(example: "US$"). default: ''
  • symbolStay: set if the symbol will stay in the field after the user exists the field. default: false
  • thousands: the thousands separator. default: ','
  • decimal: the decimal separator. default: '.'
  • precision: how many decimal places are allowed. default: 2
  • defaultZero: when the user enters the field, it sets a default mask using zero. default: true
  • 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 2 bonus methods that can be useful to you:

  • .maskMoney('destroy') which removes maskMoney from an element.
  • .maskMoney('mask') which causes maskMoney to actually apply the mask to your input.

You can also apply maskMoney using the data-* api, without writing any JavaScript! To enable, use the data-toggle="maskMoney" attribute, and optionally set any of the options as well:

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

Contributors:


License:

jQuery-maskMoney is released under the MIT license.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%