Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vuejs-tips/v-money
Tiny (<2k gzipped) input/directive mask for currency
https://github.com/vuejs-tips/v-money
Last synced: 7 days ago
JSON representation
Tiny (<2k gzipped) input/directive mask for currency
- Host: GitHub
- URL: https://github.com/vuejs-tips/v-money
- Owner: vuejs-tips
- Created: 2017-06-12T14:45:21.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2020-08-10T19:27:15.000Z (over 4 years ago)
- Last Synced: 2024-08-02T18:40:38.053Z (3 months ago)
- Language: JavaScript
- Homepage: https://vuejs-tips.github.io/v-money/
- Size: 176 KB
- Stars: 777
- Watchers: 12
- Forks: 254
- Open Issues: 71
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# v-money Mask for Vue.js
## Features
- Lightweight (<2KB gzipped)
- Dependency free
- Mobile support
- Component or Directive flavors
- Accept copy/paste
- Editable
For other types of mask, use [vue-the-mask](https://vuejs-tips.github.io/vue-the-mask)
## Usage
### A. Globally
```js
import Vue from 'vue'
import money from 'v-money'
// register directive v-money and component
Vue.use(money, {precision: 4})
```
### B. Use as component: https://jsfiddle.net/auom8st8/
```html
{{price}}
import {Money} from 'v-money'
export default {
components: {Money},
data () {
return {
price: 123.45,
money: {
decimal: ',',
thousands: '.',
prefix: 'R$ ',
suffix: ' #',
precision: 2,
masked: false
}
}
}
}
```
### C. Use as directive: https://jsfiddle.net/nj3cLoum/2/
Must use `vmodel.lazy` to bind works properly.
```html
{{price}}
import {VMoney} from 'v-money'
export default {
data () {
return {
price: 123.45,
money: {
decimal: ',',
thousands: '.',
prefix: 'R$ ',
suffix: ' #',
precision: 2,
masked: false /* doesn't work with directive */
}
}
},
directives: {money: VMoney}
}
```
## Properties
| property | Required | Type | Default | Description |
|-----------|----------|---------|---------|---------------------------------------------------------|
| precision | **true** | Number | 2 | How many decimal places |
| decimal | false | String | "." | Decimal separator |
| thousands | false | String | "," | Thousands separator |
| prefix | false | String | "" | Currency symbol followed by a Space, like "R$ " |
| suffix | false | String | "" | Percentage for example: " %" |
| masked | false | Boolean | false | If the component output should include the mask or not |
### References
- https://en.wikipedia.org/wiki/Decimal_mark
- https://docs.oracle.com/cd/E19455-01/806-0169/overview-9/index.html
- http://www.xe.com/symbols.php
- https://github.com/kevinongko/vue-numeric
- https://github.com/plentz/jquery-maskmoney