angular-currency-filter v1.0.2

Angular Currency Filter

Extend angular's built in currency filter.

Description

Formats a number as a currency (ie $1,234.56 or 914.3534€). When no currency symbol is provided, default symbol for current locale is used.

Usage

Overwrites angular's default currency filter if module: currencyFilter is injected. (complete example in the Example section)

In HTML Template Binding

{{ currency_expression | currency[:symbol[:fractionSize[:suffixSymbol]]] }}

In JavaScript

$filter('currency')(amount[, symbol[, fractionSize[, suffixSymbol]]])

Paramaters

Returns

String: Formatted number.

Use cases

// With all parameters
expect(currency(1234.4239, '€', 0, true)).toEqual('1,234€');

// With missing fraction size
expect(currency(1234.4239, '€', true)).toEqual('1,234.42€');

// With fraction size only
expect(currency(1234.4239, '$', 3)).toEqual('$1,234.424');

// Only with symbol
expect(currency(1234.4239, '$')).toEqual('$1,234.42');

Example

In HTML Template Binding

<span ng-bind="price | currency:'€':true"></span>

In JavaScript

angular.module('app', ['currencyFilter']).
    controller('Ctrl', function ( $scope, $filter ) {
            var currency = $filter('currency');
            $scope.price = currency(1234.4239, '€', 0, true);
        });

Install

Via bower

bower install --save angular-currency-filter

Include src/currency-filter.js or dist/currency-filter.min.js to your project.

<script src="/bower_components/angular-currency-filter/dist/currency-filter.min.js"></script>

Don't forget to add currencyFilter module to app's dependecies.

Test && Build

$ npm install
$ bower install

Test

$ grunt test

Build

$ grunt build