萬盛學電腦網

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

AngularJS 內建過濾器完整指南:currency、number、date、json、大小寫轉換

AngularJS (1.x) 內建豐富的過濾器,可在模板中直接格式化資料,無需在控制器預處理。本文詳細說明 6 大核心內建過濾器的語法、參數、實例與注意事項,適合 AngularJS 維護專案與學習模板驅動開發模式。

過濾器基本語法

{{ expression | filterName }}
{{ expression | filterName:arg1 }}
{{ expression | filterName:arg1:arg2 }}
{{ expression | filter1 | filter2 | filter3 }}  // 串聯多個過濾器

六大核心過濾器詳解

1. currency - 貨幣格式化

格式化數字為貨幣字串,可自訂貨幣符號與小數位數。

<!-- 預設使用當地貨幣符號 (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 -->

2. number - 數字格式化

格式化數字,支援千分位分隔、小數位數控制。非數字輸入回傳空字串。

{{ 3600 | number }}        <!-- 3,600 -->
{{ 3600 | number: 0 }}     <!-- 3,600 -->
{{ 3600 | number: 2 }}     <!-- 3,600.00 -->
{{ 3600.1234 | number: 3 }} <!-- 3,600.123 -->
{{ "abc" | number }}       <!-- "" (空字串) -->

3. date - 日期格式化

強大的日期格式化,支援預設格式字串與自訂格式。

<!-- 預設格式 -->
{{ 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 -->

<!-- 常用格式字元對照 -->






4. json - 物件序列化為 JSON 字串

除錯神器,將物件/陣列轉為美化 JSON 字串。

{{ {name: "dreamapple", language: "AngularJS"} | json }}
<!-- 輸出 -->
{
  "name": "dreamapple",
  "language": "AngularJS"
}

5. lowercase / uppercase - 大小寫轉換

{{ "HEllo" | lowercase }}  <!-- "hello" -->
{{ "HEllo" | uppercase }}  <!-- "HELLO" -->

6. limitTo / filter / orderBy (補充常用)

<!-- 限制陣列/字串長度 -->
{{ [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() : '';
        };
    });

效能注意事項

  • 避免在 ng-repeat 中使用複雜過濾器:每次 $digest 都會重新執行,大量資料會造成卡頓
  • 單次綁定:AngularJS 1.3+ 支援 `{{ ::expression | filter }}`,首次渲染後不再監聽變更
  • 在 Controller/Service 預處理:複雜邏輯移至 JS,模板只顯示結果
  • Memoization:自訂過濾器內部可用快取避免重複計算

從 AngularJS 遷移到 Angular (2+) 對照

AngularJS FilterAngular 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 或 computedAngular 無內建 filter pipe
{{ arr | orderBy:prop }}在 Component 排序Angular 無內建 orderBy pipe

結語

AngularJS 過濾器是模板驅動開發的核心特色,善用內建過濾器可大幅減少控制器邏輯。維護舊專案時請注意效能陷阱;新專案請直接使用 Angular Pipe 或框架原生的計算屬性/方法。

copyright © 萬盛學電腦網 all rights reserved