AngularJS -- 过滤器

过滤器

过略器用来格式化需要展示给用户的数据。AngularJS有很多实用的内置过滤器，
同时也提供了方便的途径可以自己创建过滤器。

在HTML总的模板绑定符号{{ }} 内通过|符号来调用过滤器。例如，假设我们
希望将字符串转换成大写，可以将字符串中的每个字符都单独进行转换操作，也
可以使用过滤器：

{{ name | uppercase }}

在JavaScript代码中可以通过$filter来调用过滤器。例如，在JavaScript代码中使用
lowercase过滤器：

app.controller('DemoController', ['$scope', '$filter',
    function($scope, $filter) {
    $scope.name = $filter('lowercase')('Ari');
}]);

以HTML的形式使用过滤器时，如果需要传递参数给过滤器，只要在过滤器名字后面加冒号
即可。如果有多个参数，可以在每个参数后面都加入冒号。例如，数值过滤器可以限制小数点后
的位数，在过滤器后写上:2可以将2作为参数传给过滤器：

{{ 123.456789 | number:2 }}
可以用|符号作为分割符来同时使用多个过滤器

currency

currency过滤器可以将一个数值格式化为货币格式。
用{{ 123 | currency }} 来将123转化成货币格式。

currency过滤器允许我们自己设置货币符号，默认情况下会采用客户端所处区域的货币符号。

date

date过滤器可以将日期格式化吃成需要的格式

• 内置的支持本地化的日期格式：

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

字符串

返回所有包含这个字符串的元素。如果我们想返回不包含该字符串的元素，在参数前加
!符号。

对象

AngularJS会将待过滤对象的属性同这个对象中的同名属性进行比较，如果属性值是字符串
就会判断是否包含该字符串。如果我们希望对全部属性都进行对比，可以将
$当作键名。

函数

对每个元素都执行这个函数，返回非假值的元素会出现在新的数组中并返回。例如，用下面的过滤器可以选择所有包含字母
e的单词：
{{ ['Ari','Lerner','Likes','To','Eat','Pizza'] | filter:'e' }}

如果要过滤对象，可以使用上面提到的对象过滤器。例如，如果有一个由
people对象组成的数组，每个对象都含有他们最喜欢吃的食物的列表，那么可以用下面的形式进行过滤：

{{ [{ 
    'name': 'Ari', 
    'City': 'San Francisco', 
    'favorite food': 'Pizza' 
    },{ 
    'name': 'Nate', 
    'City': 'San Francisco', 
    'favorite food': 'indian food' 
    }] | filter:{'favorite food': 'Pizza'} }} 
<!-- [{"name":"Ari","City":"SanFrancisco","favoritefood":"Pizza"}] -->

isCapitalized函数的功能是根据首字母是否为大写返回true或false

//HTML

<div id="emailEditor" ng-controller="MyController">
    {{ ['Ari','likes','to','travel'] | filter:isCapitalized }}
</div>

JAVASCRIPT

angular.module('myApp', [])
.controller('MyController', ['$scope', '$filter', 
  function($scope, $filter) { 
    $scope.isCapitalized = function(str) { 
	    return str[0] == str[0].toUpperCase(); 
	}; 
}]); 

我们也可以给filter过滤器传入第二个参数，用来指定预期值同实际值进行比较的方式。
第二个参数可以是以下三种情况之一。

• true 用angular.equals(expected, actual)对两个值进行严格比较。

• false 进行区分大小写的子字符串比较。

• 函数运行这个函数，如果返回真值就接受这个元素。

json过滤器可以将一个JSON或javaScript对象转换成字符串。这种转换对调试非常有帮助：
{{ {'name': 'Ari', 'City': 'SanFrancisco'} | json }}

{
 "name": "Ari",
 "City": "San Francisco"
}

limitTo过滤器会根据传入的参数生成一个新的数组或字符串，新的数组或字符串的长度
取决于传入的参数，通过传入参数的正负数来控制从前面还是后面开始截取。

如果传入的长度值大于被操作数组或字符串的长度，那么整个数组或字符串都会被返回。

{{ San Francisco is very cloudy | limitTo:3 }}
{{ San Francisco is very cloudy | limitTo:-6 }}
{{['a', 'b', 'c', 'd'] | limitTo:1 }}

lowercase过滤器将字符串转为小写。
{{ "San Francisco is very cloudy" | lowercase }}

number过滤器将数字格式化成文本。它的第二个参数是可选的，用来控制小数点后截取的位数。

如果传入了一个非数字字符，会返会空字符串。

{{ 123456789 | number }}
{{ 1.234567 | number:2 }}

orderBy过滤器可以用表达式对指定的数组进行排序。
orderBy可以接受两个参数，第一个是必需的，第二个是可选的。
第一个参数是用来确定数组排序方向的谓词。

当第一个参数是函数时，该函数会被当作待排序对象的getter方法。

对这个字符串进行解析的结果将决定数组元素的排序方向。我们可以传入
+或-来强制进行升序或降序排列。

在排序表达式中使用数组元素作为谓词。对于与表达式结果并
不严格相等的每个元素，则使用第一个谓词。

第二个参数用来控制排序的方向（是否逆向）。

{{ [{ 
    'name': 'Ari', 
    'status': 'awake' 
    },{ 
    'name': 'Q', 
    'status': 'sleeping' 
    },{ 
    'name': 'Nate', 
    'status': 'awake' 
    }] | orderBy:'name' }} 
<!--
  [
  {"name":"Ari","status":"awake"},
  {"name":"Nate","status":"awake"},
  {"name":"Q","status":"sleeping"}
  ]
-->

也可以对排序结果进行反转。例如，通过将第二个参数设置为
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"}
  ]
-->

uppercase过滤器可以将字符串转换为大写形式：

{{ "San Francisco is very cloudy" | uppercase }}

自定义过滤器

创建一个过滤器非常容易，创建自定义过滤器需要将它放到自己的模块中。
如：将字符串第一个字母转换为大写：

HTML

{{ 'abcddefg' | capitalize }}

首先，创建一个模块用以在应用中进行引用（这是一个非常好的实践）：

JAVASCRIPT

angular.module('myApp', [])
.controller('MyController', ['$scope', '$filter', 
  function($scope, $filter) { 
    //nothing
}])
.filter('capitalize', function() {
   return function(input) {
   	//input是传入的字符串
   	if (input) {
   		return input[0].toUpperCase() + input.slice(1);
   	}
   };
});