过滤器(filter)

过滤器(filter)正如其名,作用就是接收一个输入,通过某个规则进行处理,然后返回处理后的结果。
转载自走进AngularJs(七) 过滤器(filter)

一 filter的两种使用方法:

  1. 在模板中使用filter

我们可以直接在{{}}中使用filter,跟在表达式后面用 | 分割,语法如下:

{{ expression | filter }}

也可以多个filter连用,上一个filter的输出将作为下一个filter的输入

{{ expression | filter1 | filter2 | ... }}

filter可以接收参数,参数用 : 进行分割,如下:

{{ expression | filter:argument1:argument2:... }}

除了对{{}}中的数据进行格式化,我们还可以在指令中使用filter,例如先对数组array进行过滤处理,然后再循环输出:

<span ng-repeat="a in array | filter ">

2. 在controller和service中使用filter

我们的js代码中也可以使用过滤器,方式就是我们熟悉的依赖注入,如:

app.controller('testC', function($scope, currencyFilter){
    $scope.num = currencyFilter(123534);  
}

在模板中使用{{num}}就可以直接输出$123,534.00了!在服务中使用filter也是同样的道理。

此时你可能会有疑惑,如果我要在controller中使用多个filter,难道要一个一个注入吗,这岂不太费劲了?
ng提供了一个$filter服务可以来调用所需的filter,你只需注入一个$filter就够了,使用方法如下:

app.controller('testC', function($scope, $filter){
    $scope.num = $filter('currency')(123534);
    $scope.date = $filter('date')(new Date());  
}

二 ng的内置过滤器

ng内置了九种过滤器,使用方法都非常简单,看文档即懂。

  1. currency (货币处理)

使用currency可以将数字格式化为货币,默认是美元符号,你可以自己传入所需的符号,例如我传入人民币:

{{num | currency : '¥'}}

2. date (日期格式化)

原生的js对日期的格式化能力有限,ng提供的date过滤器基本可以满足一般的格式化要求。用法如下:

{{date | date : 'yyyy-MM-dd hh:mm:ss EEEE'}}

参数用来指定所要的格式,y M d h m s E 分别表示 年 月 日 时 分 秒 星期,你可以自由组合它们。也可以使用不同的个数来限制格式化的位数。另外参数也可以使用特定的描述性字符串,例如“shortTime”将会把时间格式为12:05 pm这样的。ng提供了八种描述性的字符串,个人觉得这些有点多余,我完全可以根据自己的意愿组合出想要的格式,不愿意去记这么多单词~ 3. filter(匹配子串)

这个名叫filterfilter用来处理一个数组,然后可以过滤出含有某个子串的元素,作为一个子数组来返回。可以是字符串数组,也可以是对象数组。如果是对象数组,可以匹配属性的值。它接收一个参数,用来定义子串的匹配规则。下面举个例子说明一下参数的用法,我用现在特别火的几个孩子定义了一个数组:

$scope.childrenArray = [
        {name:'kimi', age:3},
        {name:'cindy', age:4},
        {name:'anglar', age:4},
        {name:'shitou', age:6},
        {name:'tiantian', age:5}
    ];

$scope.func = function(e){
    return e.age>4;
}

示例:

{{ childrenArray | filter : 'a' }} // 匹配属性值中含有a的
{{ childrenArray | filter : 4 }}  // 匹配属性值中含有4的
{{ childrenArray | filter : {name : 'i'} }} // 参数是对象,匹配name属性中含有i的
{{ childrenArray | filter : func }}  // 参数是函数,指定返回age>4的

4. json(格式化json对象)

json过滤器可以把一个js对象格式化为json字符串,没有参数。这东西有什么用呢,我一般也不会在页面上输出一个json串啊,官网说它可以用来进行调试,嗯,是个不错的选择。或者,也可以用在js中使用,作用就和我们熟悉的JSON.stringify()一样。用法超级简单:

{{ jsonTest | json}}

5. limitTo(限制数组长度或字符串长度)

limitTo过滤器用来截取数组或字符串,接收一个参数用来指定截取的长度,如果参数是负值,则从数组尾部开始截取。个人觉得这个filter有点鸡肋,首先只能从数组或字符串的开头/尾部进行截取,其次,js原生的函数就可以代替它了,看看怎么用吧:

{{ childrenArray | limitTo : 2 }}  //将会显示数组中的前两项

6. lowercase(小写)

把整个字符串变为小写,不能指定字母。
7. uppercase(大写)

同上。
8. number(格式化数字)

number过滤器可以为一个数字加上千位分割,像这样,123,456,789。同时接收一个参数,可以指定float类型保留几位小数:

{{ num | number : 2 }}

9. orderBy(排序)

orderBy过滤器可以将一个数组中的元素进行排序,接收一个参数来指定排序规则,参数可以是一个字符串,表示以该属性名称进行排序。可以是一个函数,定义排序属性。还可以是一个数组,表示依次按数组中的属性值进行排序(若按第一项比较的值相等,再按第二项比较),还是拿上面的孩子数组举例:

<div>{{ childrenArray | orderBy : 'age' }}</div> // 按age属性值进行排序,若是-age,则倒序
<div>{{ childrenArray | orderBy : orderFunc }}</div> // 按照函数的返回值进行排序
<div>{{ childrenArray | orderBy : ['age','name'] }}</div> // 如果age相同,按照name进行排序

三 自定义过滤器

  filter的自定义方式也很简单,使用modulefilter方法,返回一个函数,该函数接收输入值,并返回处理后的结果。话不多说,我们来写一个看看。比如需要根据状态显示不同的颜色,代码如下:

App.filter('status', [function(){
    return function(text) {
        if (text == '1') {
            return "待审核";
        } else if (text == '2') {
            return "<span style='color: #5eb95e'>审核通过</span>";
        } else if (text == '3') {
            return "<span style='color: #d7342e'>审核未通过</span>";
        } else if (text == '4') {
            return "<span style='color: #d7342e'>已停用</span>";
        }
    };
}])

格式就是这样,你的处理逻辑就写在内部的那个闭包函数中。你也可以让自己的过滤器接收参数,参数就定义在return的那个函数中,作为第二个参数,或者更多个参数也可以。

四 字典转换

框架提供一个code过滤器,需要一个参数codeType,用来将字典value转换成name

<div>用户性别:{{gender | code : 'gender'}}</div>

五 $sce 输出Html

问题描述

  • 在项目当中会遇到这样的情况,后台返回的数据中带有各种各样的html标签,或者通过自定义过滤器格式化输出,如上面自定义filter示例。

  • angularjs输出html的时候,浏览器并不解析这些html标签

  • 我们用ng-bind-html这样的指令来绑定,浏览器中显示的还是html代码

解决办法---$sce

通过使用$ sce.trustAsHtml(),该方法将值转换为特权所接受并能安全地使用“ng-bind-html

我们把它封装成一个过滤器,这样就可以在模板上随时调用了

app.filter('to_trusted', ['$sce', function($sce) {
  return function (text) {
      return $sce.trustAsHtml(text);
  };
}]);

示例

<p ng-bind-html="user.status | status | to_trusted"></p>