A filter formats the value of an expression for display to the user. They can be used in view templates, controllers or services and it is easy to define your own filter.
The underlying API is the filterProvider
.
Filters can be applied to expressions in view templates using the following syntax:
{{ expression | filter }}
E.g. the markup {{ 12 | currency }}
formats the number 12 as a currency using the
filter. The resulting value is currency
$12.00
.
Filters can be applied to the result of another filter. This is called "chaining" and uses the following syntax:
{{ expression | filter1 | filter2 | ... }}
Filters may have arguments. The syntax for this is
{{ expression | filter:argument1:argument2:... }}
E.g. the markup {{ 1234 | number:2 }}
formats the number 1234 with 2 decimal points using the
filter. The resulting value is number
1,234.00
.
You can also use filters in controllers and services. For this, add a dependency with the name <filterName>Filter
to your controller or service. E.g. using the dependency numberFilter
will inject the number filter.
The injected argument is a function that takes the value to format as first argument and filter parameters
starting with the second argument.
The example below uses the filter called
.
This filter reduces arrays into sub arrays based on
conditions. The filter can be applied in the view template with markup like
filter
{{ctrl.array | filter:'a'}}
, which would do a fulltext search for "a".
However, using a filter in a view template will reevaluate the filter on
every digest, which can be costly if the array is big.
The example below therefore calls the filter directly in the controller. By this, the controller is able to call the filter only when needed (e.g. when the data is loaded from the backend or the filter expression is changed).
Writing your own filter is very easy: just register a new filter factory function with
your module. Internally, this uses the
.
This factory function should return a new filter function which takes the input value
as the first argument. Any filter arguments are passed in as additional arguments to the filter
function.filterProvider
The following sample filter reverses a text string. In addition, it conditionally makes the text upper-case.