Filtro AngularJS filter

Manual de Referência AngularJS

Definição e uso

filter Os filtros nos permitem filtrar arrays e retornar arrays que contêm apenas os itens correspondentes.

Este filtro pode ser usado apenas com arrays.

Páginas relacionadas

Tutorial AngularJS:Filtros Angular

Exemplo

Exemplo 1

Exibir itens que contêm a letra "A":



    
<li ng-repeat="x in cars | filter : 'A'">{{x}}</li>

亲自试一试

Exemplo 2

Usar objetos como filtros:



    
<li ng-repeat="x in customers | filter : {'name' : 'O', 'city' : 'London'}">
    {{x.name + ", " + x.city}}

亲自试一试

例子 3

进行“严格”比较，除非值与表达式完全相同，否则不会返回匹配项：



    

  • 
    {{x.name + ", " + x.city}}

    •

亲自试一试

语法

{{ arrayexpression | filter : expression : comparator }}

Parâmetros

Parâmetros Descrição
expression

Expressão usada para selecionar itens do array. O tipo da expressão pode ser:

String: Retornará itens do array que correspondem à string.

Objeto: O objeto é o padrão que está sendo procurado no array. Por exemplo: filter: {"name" : "H", "city": "London"} retornará itens do array cujo nome contenha a letra "H" e a cidade contenha "London". Veja o exemplo acima.

Função: Uma função que será chamada para cada item do array e os itens cuja função retornar true aparecerão no array de resultados.
comparator

Opcional. Define o grau destrictura da comparação. O valor pode ser:

true: Apenas quando o valor do item do array for exatamente igual ao valor a ser comparado, retorna o item correspondente.

false: Se o valor do item do array contiver o valor a ser comparado, retorna o item correspondente. Esta comparação não distingue entre maiúsculas e minúsculas. Este é o valor padrão.

Função: Podemos definir uma função para determinar o que é considerado correspondente ou não correspondente.

Manual de Referência AngularJS