在 Angular 中，我們不應(yīng)該試圖直接修改 DOM 的內(nèi)容，當(dāng)需要更新 DOM 內(nèi)容的時(shí)候，應(yīng)該修改的其實(shí)是我們的數(shù)據(jù)模型，也就是 $scope 中的數(shù)據(jù)，Angular 會(huì)幫助我們將修改之后的數(shù)據(jù)展示在頁面中。

但是，在有些情況下，比如我們有一個(gè)搜索框，希望將搜索的關(guān)鍵字在正文中高亮出來，這時(shí)候就會(huì)感覺比較吃力了，filter 可以幫助我們處理這種情況。

實(shí)際上，很多時(shí)候，我們的數(shù)據(jù)是不能直接輸出到 DOM 中的，典型的比如日期，或者貨幣等等，通常需要將我們內(nèi)部的數(shù)據(jù)格式化之后，再輸出到頁面中，在 Angular 中，這個(gè)工作就是通過 filter 來實(shí)現(xiàn)的。

filter 是 module 級(jí)別的服務(wù)，定義之后，可以在整個(gè) module 內(nèi)直接使用，有著極高的復(fù)用性。

為了說明問題，先回顧一下的 走進(jìn)AngularJs(七) 過濾器（filter） 說明一下過濾器，然后詳細(xì)說明如何處理搜索關(guān)鍵字高亮問題。你可以直接從自定義過濾器部分開始。

1. 過濾器的用法

1. 模板中使用

我們可以直接在{{}}中使用filter，跟在表達(dá)式后面用 | 分割，語法如下：

{{ expression | filter }}

也可以多個(gè)filter連用，上一個(gè)filter的輸出將作為下一個(gè)filter的輸入。

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

filter可以接收參數(shù)，參數(shù)用 : 進(jìn)行分隔。

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

除了對(duì){{}}中的數(shù)據(jù)進(jìn)行格式化，我們還可以在指令中使用filter，例如先對(duì)數(shù)組array進(jìn)行過濾處理，然后再循環(huán)輸出：

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

2. 在 controller 和 service 中使用

我們的js代碼中也可以使用過濾器，方式就是我們熟悉的依賴注入，例如我要在controller中使用currency過濾器，只需將它注入到該controller中即可。

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

在模板中使用{{num}}就可以直接輸出 $123,534.00了！在服務(wù)中使用filter也是同樣的道理。

此時(shí)你可能會(huì)有疑惑，如果我要在controller中使用多個(gè)filter，難道要一個(gè)一個(gè)注入嗎，這豈不太費(fèi)勁了？小兄弟莫著急~ng提供了一個(gè)$filter服務(wù)可以來調(diào)用所需的filter，你只需注入一個(gè)$filter就夠了，使用方法如下：

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

2. 內(nèi)置的 filter

1. currentcy, 使用currency可以將數(shù)字格式化為貨幣，默認(rèn)是美元符號(hào)，你可以自己傳入所需的符號(hào)

{{num | currency : '￥'}}

2. date, 原生的js對(duì)日期的格式化能力有限，ng提供的date過濾器基本可以滿足一般的格式化要求。

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

3. filter, 注意了，這個(gè)過濾器的名字叫 filter，不要搞混了。用來處理一個(gè)數(shù)組，然后可以過濾出含有某個(gè)子串的元素，作為一個(gè)子數(shù)組來返回?？梢允亲址?dāng)?shù)組，也可以是對(duì)象數(shù)組。如果是對(duì)象數(shù)組，可以匹配屬性的值。它接收一個(gè)參數(shù)，用來定義子串的匹配規(guī)則。

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

自定義的輔助函數(shù)。

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

使用 filter 過濾器

{{ childrenArray | filter : 'a' }} //匹配屬性值中含有a的
{{ childrenArray | filter : 4 }} //匹配屬性值中含有4的
{{ childrenArray | filter : {name : 'i'} }} //參數(shù)是對(duì)象，匹配name屬性中含有i的
{{childrenArray | filter : func }} //參數(shù)是函數(shù)，指定返回age>4的

4. json, 格式化 json 對(duì)象。json過濾器可以把一個(gè)js對(duì)象格式化為json字符串。作用就和我們熟悉的JSON.stringify()一樣。

{{ jsonTest | json}}

5. limitTo, limitTo過濾器用來截取數(shù)組或字符串，接收一個(gè)參數(shù)用來指定截取的長(zhǎng)度。只能從數(shù)組或字符串的開頭進(jìn)行截取

{{ childrenArray | limitTo : 2 }} //將會(huì)顯示數(shù)組中的前兩項(xiàng)

6. lowercase, 轉(zhuǎn)換為小寫。把數(shù)據(jù)轉(zhuǎn)化為全部小寫。

7. uppercase, 轉(zhuǎn)換為大寫。

8. number, 格式化數(shù)字。number過濾器可以為一個(gè)數(shù)字加上千位分割，像這樣，123,456,789。同時(shí)接收一個(gè)參數(shù)，可以指定小float類型保留幾位小數(shù)：

{{ num | number : 2 }}

9. orderBy 排序，orderBy過濾器可以將一個(gè)數(shù)組中的元素進(jìn)行排序，接收一個(gè)參數(shù)來指定排序規(guī)則，參數(shù)可以是一個(gè)字符串，表示以該屬性名稱進(jìn)行排序。可以是一個(gè)函數(shù)，定義排序?qū)傩?。還可以是一個(gè)數(shù)組，表示依次按數(shù)組中的屬性值進(jìn)行排序（若按第一項(xiàng)比較的值相等，再按第二項(xiàng)比較），

<div>{{ childrenArray | orderBy : 'age' }}</div>   //按age屬性值進(jìn)行排序
<div>{{ childrenArray | orderBy : orderFunc }}</div>  //按照函數(shù)的返回值進(jìn)行排序
<div>{{ childrenArray | orderBy : ['age','name'] }}</div> //如果age相同，按照name進(jìn)行排序

3. 自定義 filter

 我們先定義個(gè)沒有參數(shù)的過濾器。第一個(gè)例子來自 Angular 官方的文檔。

我們希望檢查數(shù)據(jù)是否為真，如果為真的話，顯示為一個(gè) ✓ ，否則的話，顯示為  ✘， 在 Unicode 中，\u2713 -> ✓， \u2718 -> ✘，所以，我們需要做的就是檢查數(shù)據(jù)是否為真，然后轉(zhuǎn)化為這兩個(gè)特殊字符進(jìn)行輸出。

app.filter('checkmark', function() {
 return function(input) {
  return input ? '\u2713' : '\u2718';
 };
});

過濾器還可以有參數(shù)，比如內(nèi)置的過濾器可以格式話貨幣或者日期。

在過濾器后面，使用冒號(hào) (:) 分隔的就是過濾器的參數(shù)，在過濾器中，可以獲取這個(gè)參數(shù)，如果有多個(gè)參數(shù)，就繼續(xù)使用冒號(hào) (:) 進(jìn)行分隔，所以，過濾器可以有多個(gè)參數(shù)。

下面實(shí)現(xiàn)一個(gè)截?cái)喑L(zhǎng)字符串的過濾器。

app.filter("truncate", function(){
  return function(text, length){
    if (text) {
      var ellipsis = text.length > length ? "..." : "";
      return text.slice(0, length) + ellipsis;
    };
    return text;    
  }
});

4. 定義高亮 filter

 我們希望搜索的關(guān)鍵字在正文中高亮出來，正文就是過濾器的第一個(gè)參數(shù)，第二個(gè)參數(shù)就是搜索關(guān)鍵字，這樣，我們的過濾器將會(huì)有兩個(gè)參數(shù)了。

高亮的原理很簡(jiǎn)單，將需要高亮的內(nèi)容使用 span 標(biāo)記隔離出來，再加上一個(gè)特殊的 class 進(jìn)行描述就可以了。

app.filter("highlight", function($sce, $log){

  var fn = function(text, search){
    $log.info("text: " + text);
    $log.info("search: " + search);

    if (!search) {
      return $sce.trustAsHtml(text);
    }
    text = encodeURI(text);
    search = encodeURI(search);

    var regex = new RegExp(search, 'gi')
    var result = text.replace(regex, '<span class="highlightedText">$&</span>');
    result = decodeURI(result);
    $log.info("result: " + result );
    return $sce.trustAsHtml(result);
  };

  return fn;
});

$sce, 和 $log 是 angular 提供的兩個(gè)服務(wù)，其中 $sce 服務(wù)需要使用  ngSanitize 模塊。關(guān)于這個(gè)模塊，可以參考：angular-ngSanitize模塊-$sanitize服務(wù)詳解

5. 定義服務(wù)對(duì)象

我們的頁面可能很復(fù)雜，需要在一個(gè)控制器中輸入關(guān)鍵字，但是，需要在多個(gè)控制器中使用這個(gè)關(guān)鍵字進(jìn)行過濾，怎么處理呢？使用服務(wù)可以解決這個(gè)問題。

在 Angular 中，服務(wù)就是一個(gè)單例對(duì)象，我們使用 factory 可以直接定義一個(gè)服務(wù)對(duì)象。

app.factory("notifyService", function(){
  var target = {
    search:"key"
  };

  return target;
});

在需要使用這個(gè)對(duì)象的地方，直接注入就可以獲取這個(gè)對(duì)象了。

6. 定義搜索 Controller

在搜索控制器中，我們希望用戶提供搜索關(guān)鍵字。為了方便檢查，我們順便將用戶的輸入展示出來。

    <div ng-controller="tools">
      <div>
        <input type="text" ng-model="notify.search" value=""/>
      </div>
      <div>
        {{notify.search}}
      </div>
    </div>

控制器的實(shí)現(xiàn)，我們將服務(wù)對(duì)象直接注入到控制器中，然后綁定到當(dāng)前的 $scope 上，以便在當(dāng)前控制器中實(shí)現(xiàn)綁定。

app.controller("tools", function($scope, notifyService){
  $scope.notify = notifyService;
});

現(xiàn)在，我們可以直接輸入搜索關(guān)鍵字，這個(gè)關(guān)鍵字將被保存到服務(wù)對(duì)象中，可以在當(dāng)前的 module 中的各個(gè)控制器中訪問這個(gè)服務(wù)對(duì)象。

7. 在內(nèi)容 Controller 中使用 filter

現(xiàn)在，我們已經(jīng)有了過濾器，也可以直接通過服務(wù)對(duì)象來獲取搜索關(guān)鍵字，現(xiàn)在組合起來就可以使用了。text 中是我們的正文內(nèi)容。

    <div ng-controller="search">
      <div ng-bind-html="text | highlight:notify.search">
      </div>
    </div>

下面再看看 highlight 和 notify.search 來自何方。

app.controller("search", function($scope, $log, notifyService){
  $scope.text = "hello, world. hello, world. hello, world.";
  $scope.notify = notifyService;
})

為了在當(dāng)前控制器中使用搜索關(guān)鍵字，關(guān)鍵是在搜索關(guān)鍵字發(fā)生變化的時(shí)候，還需要自動(dòng)更新，我們將服務(wù)對(duì)象綁定到當(dāng)前的 $scope 中，這是引用的名稱為 notify.

這樣，在復(fù)雜頁面中，我們可能存在多個(gè)控制器，在每個(gè)需要高亮的控制器中，我們只需要注入服務(wù)對(duì)象，就可以直接獲取到當(dāng)前的搜索關(guān)鍵字，配合使用過濾器，就可以直接實(shí)現(xiàn)全局高亮了。

8. 總結(jié)

結(jié)合過濾器和服務(wù)對(duì)象，我們實(shí)現(xiàn)了在復(fù)雜頁面中，對(duì)整個(gè)頁面中的內(nèi)容進(jìn)行關(guān)鍵字高亮。以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論