AngularJS Filters

Filters can be added in AngularJS to format data.

* AngularJS Filters

AngularJS provides filters to transform data:

currency Format a number to a currency format.

date Format a date to a specified format.

filter Select a subset of items from an array.

json Format an object to a JSON string.

limitTo Limits an array/string, into a specified number of elements/characters.

lowercase Format a string to lower case.

number Format a number to a string.

orderBy Orders an array by an expression.

uppercase Format a string to upper case.

* Adding Filters to Expressions

Filters can be added to expressions by using the pipe character |, followed by a filter.

The uppercase filter format strings to upper case:

Example:
<div ng-app="myapp" ng-controller="personCtrl">

<p>The name is {{ lastName | uppercase }}</p>

</div>

The lowercase filter format strings to lower case:

Example:
<div ng-app="myapp" ng-controller="personCtrl">

<p>The name is {{ lastName | lowercase }}</p>

</div>

* Adding Filters to Directives

Filters are added to directives, like ng-repeat, by using the pipe character |, followed by a filter:

Example:
The orderBy filter sorts an array:

<div ng-app="myapp" ng-controller="namesCtrl">

<ul>
<li ng-repeat="x in names | orderBy:'country'">
{{ x.name + ', ' + x.country }}
</li>
</ul>

</div>

* The currency Filter

The currency filter formats a number as currency:

Example:
<div ng-app="myapp" ng-controller="costCtrl">

<h1>Price: {{ price | currency }}</h1>

</div>

Read more about the currency filter in our AngularJS currency Filter Reference

* The filter Filter

The filter filter selects a subset of an array.

The filter filter can only be used on arrays, and it returns an array containing only the matching items.

Example:
Return the names that contains the letter "i":

<div ng-app="myapp" ng-controller="namesCtrl">

<ul>
<li ng-repeat="x in names | filter : 'i'">
{{ x }}
</li>
</ul>

</div>

* Filter an Array Based on User Input

By setting the ng-model directive on an input field, we can use the value of the input field as an expression in a filter.

Example:
<div ng-app="myapp" ng-controller="namesCtrl">

<p><input type="text" ng-model="test"></p>

<ul>
<li ng-repeat="x in names | filter : test">
{{ x }}
</li>
</ul>

</div>

By adding the ng-click directive on the table headers, we can run a function that changes the sorting order of the array:

Example:
<div ng-app="myapp" ng-controller="namesCtrl">

<table border="1" width="100%">
<tr>
<th ng-click="orderByMe('name')">Name</th>
<th ng-click="orderByMe('country')">Country</th>
</tr>
<tr ng-repeat="x in names | orderBy:myOrderBy">
<td>{{x.name}}</td>
<td>{{x.country}}</td>
</tr>
</table>

</div>

<script>
angular.module('myApp', []).controller('namesCtrl', function($scope) {
$scope.names = [
{name:'Dhaval',country:'india'},
{name:'Manthan',country:'Sweden'},
{name:'Tejas',country:'England'},
{name:'Rudra',country:'Norway'},
{name:'Viral',country:'Denmark'},
{name:'Parth',country:'Sweden'},
{name:'Deep',country:'Denmark'},
{name:'Deven',country:'England'},
{name:'Vivek',country:'Norway'}
];
$scope.orderByMe = function(x) {
$scope.myOrderBy = x;
}
});
</script>

* Custom Filters

You can make your own filters by registering a new filter factory function with your module:

Example:
Make a custom filter called "myFormat":

<ul ng-app="myapp" ng-controller="namesCtrl">
<li ng-repeat="x in names">
{{x | myFormat}}
</li>
</ul>

<script>
var app = angular.module('myapp', []);
app.filter('myFormat', function() {
return function(x) {
var i, c, txt = "";
for (i = 0; i < x.length; i++) {
c = x[i];
if (i % 2 == 0) {
c = c.toUpperCase();
}
txt += c;
}
return txt;
};
});
app.controller('namesCtrl', function($scope) {
$scope.names = ['Dhaval', 'Manthan', 'Tejas', 'Rudra', 'Viral', 'Parth', 'Deep', 'Deven', 'Vivek'];
});
</script>

The myFormat filter will format every other character to uppercase.

AngularJS Filters