Filtros AngularJS

Você pode adicionar filtros no AngularJS para formatar dados.

Filtros AngularJS

O AngularJS oferece filtros para transformar dados:

  • currency Formata um número no formato monetário
  • date Formata uma data no formato especificado
  • filter Seleciona um subconjunto de um array
  • json Formata um objeto em uma string JSON
  • limitTo Limita um array/uma string para um número específico de elementos/caracteres
  • lowercase Formata a string em minúsculas
  • number Formata um número em uma string
  • orderBy Ordena um array através de uma expressão
  • uppercase Formata a string em maiúsculas

Adicionar um filtro a uma expressão

Você pode adicionar um filtro a uma expressão usando o sinal de管道 |, seguido de um filtro.

uppercase O filtro formata a string em maiúsculas:

Exemplo

<div ng-app="myApp" ng-controller="personCtrl">
<p>Nome é {{ lastName | uppercase }}</p>
</div>

Experimente você mesmo

lowercase O filtro formata a string em minúsculas:

Exemplo

<div ng-app="myApp" ng-controller="personCtrl">
<p>O nome é {{ lastName | lowercase }}</p>
</div>

Experimente você mesmo

adicionar um filtro à diretiva

usando o caractere de管道 | seguido do filtro, você pode adicionar um filtro à diretiva, por exemplo ng-repeat:

Exemplo

O filtro orderBy ordena o array:

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

Experimente você mesmo

filtro currency

currency O filtro formata números como moeda:

Exemplo

<div ng-app="myApp" ng-controller="costCtrl">
<h1>Preço: {{ price | currency }}</h1>
</div>

Experimente você mesmo

Para mais informações sobre o filtro currency, consulte nosso manual de referência de filtros AngularJS.

filtro filter

filter O filtro seleciona um subconjunto do array.

filter O filtro pode ser usado apenas com arrays, retornando um array que contém apenas os itens correspondentes.

Exemplo

Retorna nomes que contêm a letra "i":

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

Experimente você mesmo

Para mais informações sobre o filtro filter, consulte nosso manual de referência de filtros AngularJS.

Filtre o array com base na entrada do usuário

ao configurar no campo de entrada ng-model A instrução permite usar o valor do campo de entrada como expressão no filtro.

Insira um caractere na caixa de entrada, a lista será ajustada com base nas correspondências:

  • Jani
  • Carl
  • Margareth
  • Hege
  • Joe
  • Gustav
  • Birgit
  • Mary
  • Kai

Exemplo

<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>

Experimente você mesmo

Classifique o array com base na entrada do usuário

Clique na cabeça da tabela para alterar a ordem de classificação:

Name Country Jani Norway Carl Sweden Margareth England Hege Norway Joe Denmark Gustav Sweden Birgit Denmark Mary England Kai Norway

ao adicionar na cabeça da tabela ng-click A instrução permite executar uma função que altera a ordem de classificação do array:

Exemplo

<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:'Jani',country:'Norway'},
    {name:'Carl',country:'Sweden'},
    {name:'Margareth',country:'England'},
    {name:'Hege',country:'Norway'},
    {name:'Joe',country:'Denmark'},
    {name:'Gustav',country:'Sweden'},
    {name:'Birgit',country:'Denmark'},
    {name:'Mary',country:'England'},
    {name:'Kai',country:'Norway'}
  };
  $scope.orderByMe = function(x) {
    $scope.myOrderBy = x;
  }
});
</script>

Experimente você mesmo

Filtro personalizado

Você pode criar seu próprio filtro registrando uma função fábrica de filtro nova no módulo:

Exemplo

Criar um filtro personalizado chamado "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 = ['Jani', 'Carl', 'Margareth', 'Hege', 'Joe', 'Gustav', 'Birgit', 'Mary', 'Kai'];
});
</script>

Experimente você mesmo

myFormat O filtro formatará cada caractere em alta letra a cada dois caracteres.