Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vtex/ng-currency-mask


https://github.com/vtex/ng-currency-mask

srv-oms-ui xp-post-purchase

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# Angular Currency Mask
Currency input handler for AngularJS (1.X)

## Usage

#### Reference script

Find both compiled and minified versions inside `dist` folder.

```html

```

#### Inject `vtex.ngCurrencyMask`

```coffeescript
angular.module 'yourApp', ['vtex.ngCurrencyMask']
```

#### Bind directive `currency-mask`

```html

```
*Obs: __ngModel__ is required!*

## How it works

#### Model

- Expects it to be an `int`, in cents. e.g.: `100` ($ 1), `420` ($ 4,20)
- Always receive parsed value from view input. e.g.: `'1,250.50' -> 125050`

*Obs: Will parse both `'1.250,50'` and `'1,250.50'` inputs correctly (__i18n__ differences).*

#### View

- Displays formatted model value (as `string`)
- Uses `$filter('currency')`, which uses `$locale.NUMBER_FORMATS` configuration (separators, fraction size, etc).

*Obs: Currency symbol is always hidden.*
*Pro tip: For now, if you want to, prepend or append symbol `` to ``.*

## Development - Contribute!

Inside `src` you can find this module source code, written in **CoffeeScript**.
Tests can be found in `spec` folder.

To build the `.js` and uglify it, install npm dev-dependencies and run grunt:

(sudo) npm i
grunt