时间戳

首页 > 技术文章 > AngularJS 过滤器

AngularJS 过滤器

jiaojie 2017-07-10 14:33 原文

 
过滤器是用来格式化需要展示给用户的数据。
 
1. HTML 模板中调用过滤器：{{}} 内通过 | 符号
{{ name | uppercase }}

　　

2. JavaScript 中调用过滤器
app.controller('DemoController', ['$scope', '$filter',
    function($scope, $filter) {
    $scope.name = $filter('lowercase')('Ari');
}]);
在 HTML 中给过滤器传参数，只要给过滤器名字后面加冒号即可，如果多个参数，可以在每个参数后面都加入冒号。
{{ 123.456789 | number:2 }} <!-- 显示：123.46 -->

 

下面介绍 AngularJS 提供的内置过滤器：
 
1. currency
将一个数值格式化为货币格式，默认情况下会采用客户端所处区域的货币符号。但是也可以自定义货币符号。
{{ 123 | currency }} <!-- $123.00 -->
{{ 123 | currency: "RMB" }} <!-- RMB123.00 -->
{{ 123 | currency: "￥" }} <!-- ￥123.00 -->

 

2. date
将日期格式化成需要的格式，默认采用 mediumDate 格式。
下面是内置的支持本地化的日期格式：
{{ today | date:'medium' }} <!-- Aug 09, 2013 12:09:02 PM -->
{{ today | date:'short' }} <!-- 8/9/1312:09PM -->
{{ today | date:'fullDate' }} <!-- Thursday, August 09, 2013 -->
{{ today | date:'longDate' }} <!-- August 09, 2013 -->
{{ today | date:'mediumDate' }}<!-- Aug 09, 2013 -->
{{ today | date:'shortDate' }} <!-- 8/9/13 -->
{{ today | date:'mediumTime' }}<!-- 12:09:02 PM -->
{{ today | date:'shortTime' }} <!-- 12:09 PM -->

 

  • 年份格式化
四位年份：{{ today | date:'yyyy' }} <!-- 2013 -->
两位年份：{{ today | date:'yy' }} <!-- 13 -->
一位年份：{{ today | date:'y' }} <!-- 2013 -->
  • 月份格式化
英文月份：{{ today | date:'MMMM' }} <!-- August -->
英文月份简写：{{ today | date:'MMM' }} <!-- Aug -->
数字月份：{{ today |date:'MM' }} <!-- 08 -->
一年中的第几个月份：{{ today |date:'M' }} <!-- 8 -->
  • 日期格式化
数字日期：{{ today|date:'dd' }} <!-- 09 -->
一个月中的第几天：{{ today | date:'d' }} <!-- 9 -->
英文星期：{{ today | date:'EEEE' }} <!-- Thursday -->
英文星期简写：{{ today | date:'EEE' }} <!-- Thu -->
  • 小时格式化
24小时制数字小时：{{today|date:'HH'}} <!--00-->
一天中的第几个小时：{{today|date:'H'}} <!--0-->
12小时制数字小时：{{today|date:'hh'}} <!--12-->
上午或下午的第几个小时：{{today|date:'h'}} <!--12-->
  • 分钟格式化
数字分钟数：{{ today | date:'mm' }} <!-- 09 -->
一个小时中的第几分钟：{{ today | date:'m' }} <!-- 9 -->
  • 秒数格式化
数字秒数：{{ today | date:'ss' }} <!-- 02 -->
一分钟内的第几秒：{{ today | date:'s' }} <!-- 2 -->
毫秒数：{{ today | date:'.sss' }} <!-- .995 -->
  • 字符格式化
上下午标识：{{ today | date:'a' }} <!-- AM -->
四位时区标识：{{ today | date:'Z' }} <!--- 0700 -->
 
下面是一些自定义日期格式的示例：
{{ today | date:'MMMd, y' }} <!-- Aug9, 2013 -->
{{ today | date:'EEEE, d, M' }} <!-- Thursday, 9, 8-->
{{ today | date:'hh:mm:ss.sss' }} <!-- 12:09:02.995 -->

 

3. filter
这个过滤器的第一个参数可以是字符串、对象或者一个用来从数组中选择元素的函数
  • 字符串
返回所有包含这个字符串的元素。如果我们想返回不包含该字符串的元素，在参数前加!
符号。
{{ [{id:'1', name:'abc'},{id:'2', name:'acd'},{id:'3', name:'bcd'}] | filter: 'a' }}
<!-- [{"id":"1","name":"abc"},{"id":"2","name":"acd"}] -->
 
{{ [{id:'1', name:'abc'},{id:'2', name:'acd'},{id:'3', name:'bcd'}] | filter: '!a' }}
<!-- [{"id":"3","name":"bcd"}] -->

 

  • 对象
AngularJS会将待过滤对象的属性同这个对象中的同名属性进行比较，如果属性值是字符串
就会判断是否包含该字符串。如果我们希望对全部属性都进行对比，可以将$当作键名。
  
{{ [{id:'1', name:'abc'},{id:'2', name:'acd'},{id:'3', name:'bcd'}] | filter: {'name': 'a'} }}
<!-- [{"id":"1","name":"abc"},{"id":"2","name":"acd"}] -->
 
{{ [{id:'1', name:'abc'},{id:'2', name:'acd'},{id:'3', name:'bcd'}] | filter: {'name': '!a'} }}
<!-- [{"id":"3","name":"bcd"}] -->
 
{{ [{id:'1', name:'abc'},{id:'2', name:'acd'},{id:'3', name:'bcd'}] | filter: '{$: searchWord}' }}

 

  • 函数
对每个元素都执行这个函数，返回非假值的元素会出现在新的数组中并返回。
 
{{ ['Ari','likes','to','travel'] | filter:isCapitalized }}
<!-- ["Ari"] -->
$scope.isCapitalized = function(str) {
    return str[0] == str[0].toUpperCase();
};
我们也可以给filter过滤器传入第二个参数，用来指定预期值同实际值进行比较的方式。
第二个参数可以是以下三种情况之一。
  • true
用angular.equals(expected, actual) 对两个值进行严格比较。
  • false
进行区分大小写的字符串比较
  • 函数
运行这个函数，如果返回真值就接受这个元素
 
4. json
json过滤器可以将一个JSON或JavaScript对象转换成字符串
{{ {name: 'Ari', City: 'SanFrancisco'} | json }}
<!-- { "name": "Ari", "City": "SanFrancisco" } -->
 
5. limitTo
limitTo过滤器会根据传入的参数生成一个新的数组或字符串，新的数组或字符串的长度取
决于传入的参数，通过传入参数的正负值来控制从前面还是从后面开始截取。
如果传入的长度值大于被操作数组或字符串的长度，那么整个数组或字符串都会被
返回。
例如，我们可以截取字符串的前三个字符：
{{ San Francisco is very cloudy | limitTo:3 }}
<!-- San -->
或最后的六个字符：
{{ San Francisco is very cloudy | limitTo:-6 }}
<!-- cloudy -->
对数组也可以进行同样的操作。返回数组的第一个元素：
{{ ['a','b','c','d','e','f'] | limitTo:1 }}
<!-- ["a"] -->
对对象也可以进行同样的操作，返回对象的第一个元素：
{ 
{ [{"age": 20,"id": 10,"name": "iphone"}, {"age": 12,"id": 11,"name": "sunm xing"},
{"age": 44,"id": 12,"name": "test abc"} ] | limitTo:1 }}
<!-- [{"age":20,"id":10,"name":"iphone"}] -->

 

6. lowercase
lowercase过滤器将字符串转为小写。
{{ "San Francisco is very cloudy" | lowercase }}
<!-- san francisco is very cloudy -->

 

7. uppercase
uppercase过滤器可以将字符串转换为大写形式：
{{ "San Francisco is very cloudy" | uppercase }}
<!-- SAN FRANCISCO IS VERY CLOUDY -->
 
8. number
number 过滤器将数字格式化成文本。它的第二个参数是可选的，用来控制小数点后截取的位数。
如果传入了一个非数字字符，会返回空字符串。
{{ 123456789 | number }}
<!-- 1,234,567,890 -->


{{ 1.234567 | number:2 }}
<!-- 1.23 -->

 

9. orderBy
orderBy 过滤器可以用表达式对指定的数组进行排序。
orderBy 可以接受两个参数，第一个是必需的， 第二个是可选的。
第一个参数是用来确定数组排序方向的谓词。
下面分情况讨论第一个参数的类型。
  • 函数
当第一个参数是函数时，该函数会被当作待排序对象的getter方法。
  • 字符串
对这个字符串进行解析的结果将决定数组元素的排序方向。我们可以传入+或-来强制进 行升序或降序排列。
{{ '123456789' | orderBy: '+'}} <!-- ["1","2","3","4","5","6","7","8","9"]  -->
{{ '123456789' | orderBy: '-'}} <!-- ["9","8","7","6","5","4","3","2","1"] -->
  • 数组
在排序表达式中使用数组元素作为谓词。对于与表达式结果并不严格相等的每个元素，则使用第一个谓词。
第二个参数用来控制排序的方向（是否逆向）。
false: 升序 true: 降序
{{ [{
    'name': 'Ari',
    'status': 'awake'
},{
    'name': 'Q',
    'status': 'sleeping'
},{
    'name': 'Nate',
    'status': 'awake'
}] | orderBy:'name'： true }}
<!--
    [
        {"name":"Q","status":"sleeping"},
        {"name":"Nate","status":"awake"},
        {"name":"Ari","status":"awake"}
    ]
-->

 

自定义过滤器
 
过滤器本质上是一个会把我们输入的内容当作参数传入进去的函数。
angular.module('myApp.filters', [])
    .filter('myFilter', function() {
        return function(input) {};
});

 

 
 
 
参考文献：
1.《AngularJS 权威教程》
2. http://blog.51yip.com/jsjquery/1592.html

推荐阅读