AngularJS教程二十一—— 過濾器（filter）

過濾器（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(匹配子串)

這個名叫filter的filter用來處理一個陣列，然後可以過濾出含有某個子串的元素，作為一個子陣列來返回。可以是字串陣列，也可以是物件陣列。如果是物件陣列，可以匹配屬性的值。它接收一個引數，用來定義子串的匹配規則。下面舉個例子說明一下引數的用法，我用現在特別火的幾個孩子定義了一個陣列：

$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的自定義方式也很簡單，使用module的filter方法，返回一個函式，該函式接收輸入值，並返回處理後的結果。話不多說，我們來寫一個看看。比如需要根據狀態顯示不同的顏色，程式碼如下：

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>