{"analyzedAt":"2022-06-25T17:38:41.428Z","collected":{"metadata":{"name":"vue-weblineindia-currency-input","scope":"unscoped","version":"1.0.1","description":"Easy input of currency formatted numbers for Vue.js.","keywords":["vue-weblineindia-currency-input","vue","text mask","input mask","currency input","money input","currency input-field","format","i18n","ISO 4217"],"date":"2022-05-25T13:12:36.677Z","author":{"name":"Weblineindia"},"publisher":{"username":"partners-wli","email":"partners@weblineindia.com"},"maintainers":[{"username":"partners-wli","email":"partners@weblineindia.com"}],"repository":{"type":"git","url":"git+https://github.com/weblineindia/Vue-Currency-Input.git"},"links":{"npm":"https://www.npmjs.com/package/vue-weblineindia-currency-input","homepage":"https://github.com/weblineindia/Vue-Currency-Input#readme","repository":"https://github.com/weblineindia/Vue-Currency-Input","bugs":"https://github.com/weblineindia/Vue-Currency-Input/issues"},"license":"MIT","devDependencies":{"@mdi/font":"^4.7.95","@vue/cli-plugin-babel":"^4.1.1","@vue/cli-plugin-eslint":"^4.1.1","@vue/cli-plugin-unit-jest":"^4.1.1","@vue/cli-service":"^4.1.1","@vue/eslint-config-standard":"^4.0.0","@vue/test-utils":"^1.0.0-beta.30","babel-eslint":"^10.0.3","core-js":"^3.5.0","eslint":"^5.16.0","eslint-plugin-vue":"^6.0.1","node-sass":"^7.0.1","rollup":"^1.27.13","rollup-plugin-buble":"^0.19.8","rollup-plugin-cleanup":"^3.1.1","sass-loader":"^8.0.0","vue":"^2.6.11","vue-template-compiler":"^2.6.11","vuepress":"^1.2.0","vuetify":"^2.1.15"},"peerDependencies":{"vue":"^2.5"},"releases":[{"from":"2022-05-26T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":0},{"from":"2022-03-27T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":2},{"from":"2021-12-27T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":2},{"from":"2021-06-25T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":2},{"from":"2020-06-25T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":2}],"hasSelectiveFiles":true,"readme":"# Vue Currency Input\r\n\r\nThe Vue Currency Input component allows an easy input of currency formatted numbers. It provides both standalone component (`<currency-input>`) and a custom Vue directive (`v-currency`) for decorating existing input components with currency format capabilities.\r\n\r\n## Table of contents\r\n\r\n- [Browser Support](#browser-support)\r\n- [Demo](#demo)\r\n- [Features](#features)\r\n- [Getting started](#getting-started)\r\n- [Usage](#usage)\r\n- [Available Props](#available-props)\r\n- [Methods](#methods)\r\n- [Directive options](#directive-options)\r\n- [Want to Contribute?](#want-to-contribute)\r\n- [Need Help / Support?](#need-help)\r\n- [Collection of Other Components](#collection-of-components)\r\n- [Changelog](#changelog)\r\n- [Credits](#credits)\r\n- [License](#license)\r\n- [Keywords](#Keywords)\r\n\r\n## Browser Support\r\n\r\n![Chrome](https://raw.github.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png) | ![Firefox](https://raw.github.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png) | ![Safari](https://raw.github.com/alrra/browser-logos/master/src/safari/safari_48x48.png) | ![Edge](https://raw.github.com/alrra/browser-logos/master/src/edge/edge_48x48.png) | ![IE](https://raw.github.com/alrra/browser-logos/master/src/archive/internet-explorer_9-11/internet-explorer_9-11_48x48.png) |\r\n--- | --- | --- | --- | --- |\r\n83.0 ✔ | 77.0  ✔ | 13.1.1 ✔ | 83.0 ✔ | 11.9 ✔ |\r\n\r\n## Demo\r\n\r\n[![](currency-input.gif)](https://github.com/weblineindia/Vue-Currency-Input/currency-input.gif)\r\n\r\n## Features\r\n\r\n* Format as you type\r\n* Locale dependent, ISO-compliant currency formatting\r\n* Distraction free (hides the formatting on focus for easier input)\r\n* Customizable currency symbols and precision ranges\r\n* Built-in value range validation\r\n* Works with input components of popular frameworks like [Vuetify](https://vuetifyjs.com/en/components/text-fields) or [Element](https://element.eleme.io/#/en-US/component/input))\r\n\r\n\r\n\r\n## Getting started\r\n\r\nInstall the npm package:\r\n\r\n``` bash\r\nnpm install vue-weblineindia-currency-input \r\n# OR \r\nyarn add vue-weblineindia-currency-input\r\n```\r\n\r\n## Usage\r\n\r\nAdd the Vue plugin in your `main.js`:\r\n``` js\r\nimport Vue from 'vue'\r\nimport VueCurrencyInput from 'vue-weblineindia-currency-input'\r\n\r\nVue.use(VueCurrencyInput)\r\n```\r\n\r\nUse the `<vue-weblineindia-currency-input>` component:\r\n``` vue\r\n<template>\r\n  <div>\r\n  <currency-input v-model=\"value\" currency=\"INR\" locale=\"en-IN\"/>\r\n  </div>\r\n</template>\r\n\r\n<script>\r\nexport default {\r\n  data: () => ({ value: 1000 })\r\n}\r\n</script>\r\n```\r\n## Available Props\r\nName | Type | Description\r\n--- | --- | --- \r\n`value` | Number |  The value of the input. `v-model` is supported.\r\n`currency` | String/Object | A [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code (for example `USD` or `EUR`). Default is `EUR`. You can also pass an object `{prefix, suffix}` for customizing the currency symbol or `null` to hide the currency symbol permanently.\r\n`locale` | String | A [BCP 47](https://tools.ietf.org/html/bcp47) language tag (for example `en` or `de-DE`). Default is `undefined` (use the runtime's default locale).\r\n`auto-decimal-mode` | Boolean | Whether the decimal symbol is inserted automatically, using the last inputted digits as decimal digits. Default is `false` (the decimal symbol needs to be inserted manually).\r\n`precision` | Number/Object | The number of displayed decimal digits. Default is `undefined` (use the currency's default). Must be between 0 and 20 and can only be applied for currencies that support decimal digits. You can also pass an object `{min, max}` to use a precision range (ranges are not available when using `auto-decimal-mode` or `value-as-integer`).\r\n`distraction-free` | Boolean/Object | Whether to hide negligible decimal digits, the currency symbol and the grouping symbol on focus. Default is `true`. You can also pass an object of boolean properties to configure each option: `{hideNegligibleDecimalDigits, hideCurrencySymbol, hideGroupingSymbol}`. Using `false` will leave the formatted value untouched on focus.\r\n`value-as-integer` | Boolean | Whether the number value should be handled as integer instead of float value. Default is `false`.\r\n`value-range` | Object | The range of accepted values as object `{min, max}`. Default is `undefined` (no value range). The validation is triggered on blur and automatically sets the respective threshold if out of range.\r\n`allow-negative` | Boolean | Whether the input of negative values is allowed. Default is `true`. If `false` it prevents the user to press <kbd>-</kbd>.\r\n-----\r\n\r\n### Methods\r\nName | Arguments | Description\r\n--- | --- | --- \r\n`setValue` | `value` (Number) | Sets a value programmatically.\r\n\r\n### Directive options\r\nThe `v-currency` directive supports the same options as the `<currency-input>` component which have to be passed as object:\r\n\r\nAdd the Vue plugin in your `main.js`:\r\n``` js\r\nimport Vue from 'vue'\r\nimport VueCurrencyInput from 'vue-weblineindia-currency-input'\r\n\r\nVue.use(VueCurrencyInput)\r\n```\r\n\r\nUse the `v-currency`directive :\r\n\r\n```vue\r\n<template>\r\n <div>\r\n  <input v-currency=\"{\r\n   currency:'INR' ,\r\n   locale:'en-IN'\r\n  }\"/>\r\n  </div>\r\n</template>\r\n```\r\n\r\n## Want to Contribute?\r\n\r\n- Created something awesome, made this code better, added some functionality, or whatever (this is the hardest part).\r\n- [Fork it](http://help.github.com/forking/).\r\n- Create new branch to contribute your changes.\r\n- Commit all your changes to your branch.\r\n- Submit a [pull request](http://help.github.com/pull-requests/).\r\n\r\n-----\r\n\r\n## Need Help? \r\n\r\nWe also provide a free, basic support for all users who want to use this VueJS Currency input in their software project. In case you want to customize this Currency input to suit your development needs, then feel free to contact our [VueJS developers](https://www.weblineindia.com/hire-vuejs-developer.html).\r\n\r\n-----\r\n\r\n## Collection of Components\r\n\r\nWe have built many other components and free resources for software development in various programming languages. Kindly click here to view our [Free Resources for Software Development](https://www.weblineindia.com/software-development-resources.html).\r\n\r\n------\r\n\r\n## Changelog\r\n\r\nDetailed changes for each release are documented in [CHANGELOG.md](./CHANGELOG.md).\r\n\r\n## Credits\r\n\r\nvue-weblineindia-currency-input is inspired by the [vue-currency-input](https://www.npmjs.com/package/vue-currency-input).\r\n\r\n## License\r\n\r\n[MIT](LICENSE)\r\n\r\n[mit]: https://github.com/weblineindia/Vue-Currency-Input/blob/master/LICENSE\r\n\r\n## Keywords\r\n\r\nvue-weblineindia-currency-input, vue, text mask, input mask, currency input, money input, currency input-field, input formatter, input field component, vue components, vuejs, vuejs component"},"npm":{"downloads":[{"from":"2022-06-24T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":1},{"from":"2022-06-18T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":3},{"from":"2022-05-26T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":31},{"from":"2022-03-27T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":101},{"from":"2021-12-27T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":152},{"from":"2021-06-25T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":342}],"starsCount":0},"github":{"homepage":"https://www.weblineindia.com/software-development-resources.html","starsCount":1,"forksCount":0,"subscribersCount":2,"issues":{"count":2,"openCount":0,"distribution":{"3600":2,"10800":0,"32400":0,"97200":0,"291600":0,"874800":0,"2624400":0,"7873200":0,"23619600":0,"70858800":0,"212576400":0},"isDisabled":false},"contributors":[{"username":"partners-wli","commitsCount":8}],"commits":[{"from":"2022-06-18T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":0},{"from":"2022-05-26T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":0},{"from":"2022-03-27T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":2},{"from":"2021-12-27T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":2},{"from":"2021-06-25T00:00:00.000Z","to":"2022-06-25T00:00:00.000Z","count":2}]},"source":{"files":{"readmeSize":6610,"testsSize":0,"hasChangelog":true},"linters":["eslint"]}},"evaluation":{"quality":{"carefulness":0.9999999999999999,"tests":0,"health":1,"branding":0},"popularity":{"communityInterest":4,"downloadsCount":33.666666666666664,"downloadsAcceleration":0.0009512937595129445,"dependentsCount":0},"maintenance":{"releasesFrequency":0.5366438356164384,"commitsFrequency":0.12801369863013698,"openIssues":1,"issuesDistribution":1}},"score":{"final":0.5260791099227642,"detail":{"quality":0.55,"popularity":0.03268910257611356,"maintenance":0.9989654972032129}}}