AngularJS (1.x) 內建豐富的過濾器,可在模板中直接格式化資料,無需在控制器預處理。本文詳細說明 6 大核心內建過濾器的語法、參數、實例與注意事項,適合 AngularJS 維護專案與學習模板驅動開發模式。
{{ expression | filterName }}
{{ expression | filterName:arg1 }}
{{ expression | filterName:arg1:arg2 }}
{{ expression | filter1 | filter2 | filter3 }} // 串聯多個過濾器
格式化數字為貨幣字串,可自訂貨幣符號與小數位數。
<!-- 預設使用當地貨幣符號 (en-US 為 $) -->
{{ 3600 | currency }} <!-- $3,600.00 -->
<!-- 自訂貨幣符號 -->
{{ 3600 | currency: "¥" }} <!-- ¥3,600.00 -->
{{ 3600 | currency: "$¥" }} <!-- $¥3,600.00 -->
<!-- 自訂小數位數 (AngularJS 1.3+) -->
{{ 3600.5 | currency: "¥": 0 }} <!-- ¥3,601 -->
{{ 3600.5 | currency: "¥": 3 }} <!-- ¥3,600.500 -->
格式化數字,支援千分位分隔、小數位數控制。非數字輸入回傳空字串。
{{ 3600 | number }} <!-- 3,600 -->
{{ 3600 | number: 0 }} <!-- 3,600 -->
{{ 3600 | number: 2 }} <!-- 3,600.00 -->
{{ 3600.1234 | number: 3 }} <!-- 3,600.123 -->
{{ "abc" | number }} <!-- "" (空字串) -->
強大的日期格式化,支援預設格式字串與自訂格式。
<!-- 預設格式 -->
{{ today | date }} <!-- "Jan 13, 2015" -->
{{ today | date: 'medium' }} <!-- "Jan 13, 2015 8:18:38 PM" -->
{{ today | date: 'short' }} <!-- "1/13/15 8:18 PM" -->
{{ today | date: 'fullDate' }} <!-- "Tuesday, January 13, 2015" -->
{{ today | date: 'longDate' }} <!-- "January 13, 2015" -->
{{ today | date: 'shortTime' }} <!-- "8:18 PM" -->
<!-- 自訂格式 (常用格式字元) -->
{{ today | date: 'yyyy-MM-dd' }} <!-- 2015-01-13 -->
{{ today | date: 'yyyy-MM-dd HH:mm:ss' }} <!-- 2015-01-13 20:18:38 -->
{{ today | date: 'EEE, MMM d, y' }} <!-- Tue, Jan 13, 2015 -->
<!-- 常用格式字元對照 -->
除錯神器,將物件/陣列轉為美化 JSON 字串。
{{ {name: "dreamapple", language: "AngularJS"} | json }}
<!-- 輸出 -->
{
"name": "dreamapple",
"language": "AngularJS"
}
{{ "HEllo" | lowercase }} <!-- "hello" -->
{{ "HEllo" | uppercase }} <!-- "HELLO" -->
<!-- 限制陣列/字串長度 -->
{{ [1,2,3,4,5] | limitTo: 3 }} <!-- [1,2,3] -->
{{ "hello world" | limitTo: 5 }} <!-- "hello" -->
{{ "hello world" | limitTo: -6 }} <!-- "world" (從尾部取) -->
<!-- 陣列過濾 -->
<li ng-repeat="item in items | filter: searchText">...</li>
<li ng-repeat="item in items | filter: {name: 'John', active: true}">...</li>
<!-- 陣列排序 -->
<li ng-repeat="item in items | orderBy: 'name'">...</li>
<li ng-repeat="item in items | orderBy: '-age'">...</li> <!-- 降序 -->
<li ng-repeat="item in items | orderBy: ['name', '-age']">...</li>
註冊自訂過濾器模組化專案邏輯:
angular.module('myApp.filters', [])
.filter('truncate', function() {
return function(input, length, suffix) {
if (!input) return '';
length = length || 50;
suffix = suffix || '...';
return input.length > length ? input.substring(0, length) + suffix : input;
};
})
.filter('capitalize', function() {
return function(input) {
return input ? input.charAt(0).toUpperCase() + input.slice(1).toLowerCase() : '';
};
});
| AngularJS Filter | Angular Pipe | 備註 |
|---|---|---|
| {{ val | currency }} | {{ val | currency:'USD' }} | Angular 管道需引入 CommonModule |
| {{ val | number }} | {{ val | number:'1.2-2' }} | 格式字串語法不同 |
| {{ val | date }} | {{ val | date:'yyyy-MM-dd' }} | 類似但時區處理不同 |
| {{ val | json }} | {{ val | json }} | 相同 |
| {{ val | lowercase }} | {{ val | lowercase }} | 相同 |
| {{ val | uppercase }} | {{ val | uppercase }} | 相同 |
| {{ arr | filter:q }} | 在 Component 用 pipe 或 computed | Angular 無內建 filter pipe |
| {{ arr | orderBy:prop }} | 在 Component 排序 | Angular 無內建 orderBy pipe |
AngularJS 過濾器是模板驅動開發的核心特色,善用內建過濾器可大幅減少控制器邏輯。維護舊專案時請注意效能陷阱;新專案請直接使用 Angular Pipe 或框架原生的計算屬性/方法。