AngularJS Filter用法詳解

無上@訣發表於2015-05-20

上一篇講了AngularJS自定義Directive,本篇是要講到AngularJS的Filter。

Filter簡介

Filter是用來格式化資料用的。

Filter的基本原型( ‘|’ 類似於Linux中的管道模式):

{{ expression | filter }}

Filter可以被鏈式使用(即連續使用多個filter):

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

Filter也可以指定多個引數:

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

AngularJS內建的Filter

AngularJS內建了一些常用的Filter,我們一一來看一下。

currencyFilter(currency):

用途:格式化貨幣

方法原型:

function(amount, currencySymbol, fractionSize)

用法:

1 {{ 12 | currency}}  <!--將12格式化為貨幣,預設單位符號為 '$', 小數預設2位-->
2 
3 {{ 12.45 | currency:'¥'}} <!--將12.45格式化為貨幣,使用自定義單位符號為 '¥', 小數預設2位-->
4 
5 {{ 12.45 | currency:'CHY¥':1}} <!--將12.45格式化為貨幣,使用自定義單位符號為 'CHY¥', 小數指定1位, 會執行四捨五入操作 -->
6 
7 {{ 12.55 | currency:undefined:0}} <!--將12.55格式化為貨幣, 不改變單位符號, 小數部分將四捨五入 -->

dateFilter(date):

用途:格式化日期

方法原型:

function(date, format, timezone)

用法:

<!--使用ISO標準日期格式 -->
{{ '2015-05-20T03:56:16.887Z' | date:"MM/dd/yyyy @ h:mma"}}

<!--使用13位(單位:毫秒)時間戳 -->
{{ 1432075948123 | date:"MM/dd/yyyy @ h:mma"}}

<!--指定timezone為UTC -->
{{ 1432075948123 | date:"MM/dd/yyyy @ h:mma":"UTC"}}

filterFilter(filter):

用途:過濾陣列

方法原型:

function(array, expression, comparator)

用法1(引數expression使用String):

1 <div ng-init="myArr = [{name:'Tom', age:20}, {name:'Tom Senior', age:50}, {name:'May', age:21}, {name:'Jack', age:20}, {name:'Alice', age:22}]">
2     <!-- 引數expression使用String,將全文搜尋關鍵字 'a' -->
3     <div ng-repeat="u in myArr | filter:'a' ">
4         <p>Name:{{u.name}}</p>
5         <p>Age:{{u.age}}</p>
6         <br />
7     </div>
8 </div>

用法2(引數expression使用function):

 1 // 先在Controller中定義function: myFilter
 2 $scope.myFilter = function (item) {
 3     return item.age === 20;
 4 };
 5 
 6 <div ng-repeat="u in myArr | filter:myFilter ">
 7     <p>Name:{{u.name}}</p>
 8     <p>Age:{{u.age}}</p>
 9     <br />
10 </div>

用法3(引數expression使用object):

1 <div ng-init="myArr = [{name:'Tom', age:20}, {name:'Tom Senior', age:50}, {name:'May', age:21}, {name:'Jack', age:20}, {name:'Alice', age:22}]">
2     <div ng-repeat="u in myArr | filter:{age: 21} ">
3         <p>Name:{{u.name}}</p>
4         <p>Age:{{u.age}}</p>
5         <br />
6     </div>
7 </div>

用法4(指定comparator為true或false):

 1 <div ng-init="myArr = [{name:'Tom', age:20}, {name:'Tom Senior', age:50}, {name:'May', age:21}, {name:'Jack', age:20}, {name:'Alice', age:22}]">
 2     Name:<input ng-model="yourName" />
 3     <!-- 指定comparator為false或者undefined,即為預設值可不傳,將以大小寫不敏感的方式匹配任意內容 -->
 4     <!-- 可以試試把下面程式碼的comparator為true,true即大小寫及內容均需完全匹配 -->
 5     <div ng-repeat="u in myArr | filter:{name:yourName}:false ">
 6         <p>Name:{{u.name}}</p>
 7         <p>Age:{{u.age}}</p>
 8         <br />
 9     </div>
10 </div>

用法5(指定comparator為function):

 1 // 先在Controller中定義function:myComparator, 此function將能匹配大小寫不敏感的內容,但與comparator為false的情況不同的是,comparator必須匹配全文
 2 $scope.myComparator = function (expected, actual) {
 3     return angular.equals(expected.toLowerCase(), actual.toLowerCase());
 4 }
 5 
 6 <div ng-init="myArr = [{name:'Tom', age:20}, {name:'Tom Senior', age:50}, {name:'May', age:21}, {name:'Jack', age:20}, {name:'Alice', age:22}]">
 7     Name:<input ng-model="yourName" />
 8     <div ng-repeat="u in myArr | filter:{name:yourName}:myComparator ">
 9         <p>Name:{{u.name}}</p>
10         <p>Age:{{u.age}}</p>
11         <br />
12     </div>
13 </div>

jsonFilter(json):

方法原型:

function(object, spacing)

用法(將物件格式化成標準的JSON格式):

{{ {name:'Jack', age: 21} | json}}

limitToFilter(limitTo):

方法原型:

function(input, limit)

用法(選取前N個記錄):

1 <div ng-init="myArr = [{name:'Tom', age:20}, {name:'Tom Senior', age:50}, {name:'May', age:21}, {name:'Jack', age:20}, {name:'Alice', age:22}]">
2     <div ng-repeat="u in myArr | limitTo:2">
3         <p>Name:{{u.name}}
4         <p>Age:{{u.age}}
5     </div>
6 </div>

lowercaseFilter(lowercase)/uppercaseFilter(uppercase):

方法原型:

function(string)

用法:

China has joined the {{ "wto" | uppercase }}.
We all need {{ "MONEY" | lowercase }}.

numberFilter(number):

方法原型:

function(number, fractionSize)

用法:

{{ "3456789" | number}}
<br />
{{ true | number}}
<br />
{{ 12345678 | number:1}}

orderByFilter(orderBy):

方法原型:

function(array, sortPredicate, reverseOrder)

用法:

 1 <div ng-init="myArr = [{name:'Tom', age:20, deposit: 300}, {name:'Tom', age:22, deposit: 200}, {name:'Tom Senior', age:50, deposit: 200}, {name:'May', age:21, deposit: 300}, {name:'Jack', age:20, deposit:100}, {name:'Alice', age:22, deposit: 150}]">
 2     <!--deposit前面的'-'表示deposit這列倒敘排序,預設為順序排序
 3     引數reverseOrder:true表示結果集倒敘顯示-->
 4     <div ng-repeat="u in myArr | orderBy:['name','-deposit']:true">
 5         <p>Name:{{u.name}}</p>
 6         <p>Deposit:{{u.deposit}}</p>
 7         <p>Age:{{u.age}}</p>
 8         <br />
 9     </div>
10 </div>

自定義Filter

和Directive一樣,如果內建的Filter不能滿足你的需求,你當然可以定義一個專屬於你自己的Filter。我們來做一個自己的Filter:capitalize_as_you_want,該Filter會使你輸入的字串中的首字母、指定index位置字母以及指定的字母全部大寫。

方法原型:

function (input, capitalize_index, specified_char)

完整的示例程式碼:

 1 <!DOCTYPE>
 2 <html>
 3 <head>
 4     <script src="/Scripts/angular.js"></script>
 5     <script type="text/javascript">
 6         (function () {
 7             var app = angular.module('ngCustomFilterTest', []);
 8 
 9             app.filter('capitalize_as_you_want', function () {
10                 return function (input, capitalize_index, specified_char) {
11                     input = input || '';
12                     var output = '';
13 
14                     var customCapIndex = capitalize_index || -1;
15 
16                     var specifiedChar = specified_char || '';
17 
18                     for (var i = 0; i < input.length; i++) {
19                         // 首字母肯定是大寫的, 指定的index的字母也大寫
20                         if (i === 0 || i === customCapIndex) {
21                             output += input[i].toUpperCase();
22                         }
23                         else {
24                             // 指定的字母也大寫
25                             if (specified_char != '' && input[i] === specified_char) {
26                                 output += input[i].toUpperCase();
27                             }
28                             else {
29                                 output += input[i];
30                             }
31                         }
32                     }
33 
34                     return output;
35                 };
36             });
37 
38         })();
39     </script>
40 </head>
41 <body ng-app="ngCustomFilterTest">
42     <input ng-model="yourinput" type="text">
43     <br />
44     Result: {{ yourinput | capitalize_as_you_want:3:'b' }}
45 </body>
46 </html>

好了,本篇講了AngularJS中的Filter,看完這篇後,我們可以利用好Filter非常方便的使資料能按我們的要求進行展示,從而使頁面變得更生動。

參考資料

AngularJS官方文件:https://docs.angularjs.org/guide/filter

CodeSchool快速入門視訊:http://campus.codeschool.com/courses/shaping-up-with-angular-js/intro

Fun with AngularJS filter: http://sarahbranon.com/post/69604997957/fun-with-angularjs-filters-part-1-the-filter

相關文章