萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

AngularJS 自訂過濾器開發指南:從參數解析到實際過濾邏輯

AngularJS 內建過濾器功能強大,但業務邏輯常需客製化過濾。本文詳細解析自訂過濾器的參數傳遞機制、回傳值處理,並提供完整可執行範例:過濾電話號碼含「555」的聯絡人。

自訂過濾器語法

HTML 中使用:{{ friends | myfilter:param1:param2:param3:windowScopedFilter }}

  • 第一個參數自動綁定為輸入陣列(input)
  • 後續參數以冒號分隔對應 param1、param2...paramN
  • 過濾器函式回傳過濾後的新陣列

核心實作:支援動態參數與外部函式回調

var myapp = angular.module('MyFilterApp', []);

myapp.filter('myfilter', function() {
  return function(input, param1) {
    // 參數轉陣列:arguments[0]=input, [1]=param1, [2]=param2...
    var args = Array.prototype.slice.call(arguments);

    // 除錯輸出(可移除)
    console.log("input:", input);
    console.log("param1:", args[1]);
    if (args.length >= 3) console.log("param2:", args[2]);
    if (args.length >= 4) console.log("param3:", args[3]);

    // 核心邏輯:若傳入第 5 參數(索引 4)為函式名稱字串,則呼叫 window[函式名] 執行實際過濾
    if (args.length >= 5) {
      return window[args[4]](input);
    }
    return input; // 無過濾函式則回傳原陣列
  };
});

全域過濾函式實作

function windowScopedFilter(input) {
  var output = [];
  angular.forEach(input, function(item) {
    if (item.phone.indexOf("555") !== -1) { // 含 555
      output.push(item);
    }
  });
  return output;
}

完整 HTML 範例

<html ng-app="MyFilterApp">
<head>
  <script src="angular.min.js"></script>
  <script>
    // 上述 filter 與 windowScopedFilter 定義
    function windowScopedFilter(input) { ... }
    var myapp = angular.module('MyFilterApp', []);
    myapp.filter('myfilter', function() { ... });
    function Ctrl($scope) {
      $scope.friends = [
        {name:'John', phone:'555-1276'}, {name:'Annie', phone:'800-BIG-MARY'},
        {name:'Mike', phone:'555-4321'}, {name:'Adam', phone:'555-5678'},
        {name:'David', phone:'555-8765'}, {name:'Mikay', phone:'555-5678'}
      ];
    }
  </script>
</head>
<body ng-controller="Ctrl">
  <ul>
    <li ng-repeat="f in friends | myfilter:'param1':'param2':true:'windowScopedFilter'">
      {{f.name}} - {{f.phone}}
    </li>
  </ul>
</body>
</html>

輸出結果

John - 555-1276
Mike - 555-4321
Adam - 555-5678
David - 555-8765
Mikay - 555-5678

關鍵技術點

  • arguments 陣列化: Array.prototype.slice.call(arguments) 將類陣列轉為真正陣列
  • 動態函式呼叫: window[args[4]](input) 允許 HTML 模板指定過濾邏輯函式名稱,極具擴充性
  • 純函式特性: 過濾器不應修改原始輸入,回傳新陣列,確保效能與可預測性
  • 依賴注入: 過濾器工廠函式可注入 Service(如 $http)執行非同步過濾(需回傳 Promise,搭配 resolve 機制)

效能建議

  • 避免在過濾器中執行昂貴運算,必要時使用 $watch 預計算或 memoize 快取
  • 大量資料建議在 Controller/Service 層預先過濾,減少模板重複運算
  • 單次綁定 ::(Angular 1.3+)可靜態化無變動列表
copyright © 萬盛學電腦網 all rights reserved