Angular 2 Pipe

更新时间 - 2017-03-20 16:15;
更新内容 - 日期格式化示例输出结果,感谢 天之骄子 刊误

Angular 2 中 Pipe(管道) 与 Angular 1.x 中的 filter(过滤器) 的作用的是一样的。它们都是用来对输入的数据进行处理,如大小写转换、数值和日期格式化等。

Angular 2 Pipe_第1张图片

Angular 2 内建管道及分类

  • String -> String

    • UpperCasePipe

    • LowerCasePipe

    • TitleCasePipe

  • Number -> String

    • DecimalPipe

    • PercentPipe

    • CurrencyPipe

  • Object -> String

    • JsonPipe

    • DatePipe

  • Tools

    • SlicePipe

    • AsyncPipe

    • I18nPluralPipe

    • I18nSelectPipe

Angular 2 内建管道使用示例

1.大写转换

{{ 'Angular' | uppercase }}

{{ 'Angular' | uppercase }}

2.小写转换

{{ 'Angular' | lowercase }}

{{ 'Angular' | lowercase }}

3.数值格式化

{{ 3.14159265 | number: '1.4-4' }}

{{ 3.14159265 | number: '1.4-4' }}

4.日期格式化

{{ today | date: 'shortTime' }}

{{ today | date: 'shortTime' }}

5.JavaScript 对象序列化

{{ { name: 'semlinker' } | json }}

{{ { name: 'semlinker' } | json }}

管道参数

管道可以接收任意数量的参数,使用方式是在管道名称后面添加 : 和参数值。如 number: '1.4-4' ,若需要传递多个参数则参数之间用冒号隔开,具体示例如下:

{{ 'semlinker' | slice:0:3 }}

{{ 'semlinker' | slice:0:3 }}

管道链

我们可以将多个管道连接在一起,组成管道链对数据进行处理。

{{ 'semlinker' | slice:0:3 | uppercase }}

{{ 'semlinker' | slice:0:3 | uppercase }}

完整示例

import { Component } from '@angular/core';

@Component({
  selector: 'my-app',
  template: `
    

{{ 'Angular' | uppercase }}

{{ 'Angular' | uppercase }}

{{ 'Angular' | lowercase }}

{{ 'Angular' | lowercase }}

{{ 3.14159265 | number: '1.4-4' }}

{{ 3.14159265 | number: '1.4-4' }}

{{ today | date: 'shortTime' }}

{{ today | date: 'shortTime' }}

{{ { name: 'semlinker' } | json }}

{{ { name: 'semlinker' } | json }}

{{ 'semlinker' | slice:0:3 }}

{{ 'semlinker' | slice:0:3 }}

{{ 'semlinker' | slice:0:3 | uppercase }}

{{ 'semlinker' | slice:0:3 | uppercase }}

`, }) export class AppComponent { today = new Date(); }

自定义管道

自定义管道的步骤:

  • 使用 @Pipe 装饰器定义 Pipe 的 metadata 信息,如 Pipe 的名称 - 即 name 属性

  • 实现 PipeTransform 接口中定义的 transform 方法

1.1 WelcomePipe 定义

import { Pipe, PipeTransform } from '@angular/core';

@Pipe({ name: 'welcome' })
export class WelcomePipe implements PipeTransform {
  transform(value: string): string {
    if(!value) return value;
    if(typeof value !== 'string') {
      throw new Error('Invalid pipe argument for WelcomePipe');
    }
    return "Welcome to " + value;
  }
} 

1.2 WelcomePipe 使用

{{ 'semlinker' | welcome }}

{{ 'semlinker' | welcome }}

当 WelcomePipe 的输入参数,即 value 值为非字符串时,如使用 123,则控制台将会抛出以下异常:

EXCEPTION: Error in ./AppComponent class AppComponent - inline template:23:9 caused by: Invalid pipe argument for WelcomePipe

2.1 RepeatPipe 定义

import {Pipe, PipeTransform} from '@angular/core';

@Pipe({name: 'repeat'})
export class RepeatPipe implements PipeTransform {
    transform(value: any, times: number) {
        return value.repeat(times);
    }
}

2.2 RepeatPipe 使用

{{ 'lo' | repeat:3 }}

{{ 'lo' | repeat:3 }}

管道分类

  • pure 管道:仅当管道输入值变化的时候,才执行转换操作,默认的类型是 pure 类型。(备注:输入值变化是指原始数据类型如:string、number、boolean 等的数值或对象的引用值发生变化)

  • impure 管道:在每次变化检测期间都会执行,如鼠标点击或移动都会执行 impure 管道

管道探秘

1.Pipe 相关接口与 PipeDecorator

Pipe 接口定义

export interface Pipe {
  name: string;
  pure?: boolean;
}

PipeDecorator

export const Pipe: PipeDecorator = makeDecorator('Pipe', {
  name: undefined,
  pure: true, // 默认是pure
});

PipeTransform 接口定义

export interface PipeTransform {
  transform(value: any, ...args: any[]): any;
}

2.RepeatPipe 详解

2.1 RepeatPipe 定义

@Pipe({name: 'repeat'})
export class RepeatPipe implements PipeTransform {
    transform(value: any, times: number) {
        return value.repeat(times);
    }
}

2.2 RepeatPipe 转换为 ES 5 代码片段

__decorate = (this && this.__decorate) || function (decorators, target, key, desc) {...};
                                                                                                  
var core_1 = require('@angular/core');
var RepeatPipe = (function () {
    function RepeatPipe() { }
    RepeatPipe.prototype.transform = function (value, times) {
        if (!value) return;
        return value.repeat(times);
    };
    RepeatPipe = __decorate([
        core_1.Pipe({ name: 'repeat' }), // 调用PipeDecorator返回TypeDecorator函数
        __metadata('design:paramtypes', [])
    ], RepeatPipe);
    return RepeatPipe;
}());

2.3 通过 Reflect API 保存后的对象信息

Angular 2 Pipe_第2张图片

2.4 管道解析 - PipeResolver 源码片段

// @angular/compiler/src/pipe_resolver.ts
@CompilerInjectable()
export class PipeResolver {
  constructor(private _reflector: ɵReflectorReader = ɵreflector) {}

  // 通过内部的ɵReflectorReader对象提供的API读取metadata信息
  resolve(type: Type, throwIfNotFound = true): Pipe {
    const metas = this._reflector.annotations(resolveForwardRef(type));
    if (metas) {
      // 读取保存的Pipe metadata 信息
      const annotation = ListWrapper.findLast(metas, _isPipeMetadata);
      if (annotation) { return annotation; }
    }
    if (throwIfNotFound) {
      throw new Error(`No Pipe decorator found on ${stringify(type)}`);
    }
    return null;
  }
}

2.5 RepeatPipe 管道的创建与执行

2.5.1 管道的创建

// JS has NaN !== NaN
function looseIdentical(a, b): boolean {
  return a === b || typeof a === 'number' && typeof b === 'number' 
    && isNaN(a) && isNaN(b);
}

// 用于检测管道的输入值或参数值是否变化,若发生变化则自动调用管道transform转换函数
function jit_pureProxy214(fn) {
        var result;
        var v0 = UNINITIALIZED; // { toString: function() { return 'CD_INIT_VALUE'} };
        var v1 = UNINITIALIZED; 
        return function (p0, p1) { 
            if (!looseIdentical(v0, p0) || !looseIdentical(v1, p1)) {
                v0 = p0; // p0: "lo"
                v1 = p1; // p1: 3
            // fn: transform(value: any, times: number) { return value.repeat(times); }
                result = fn(p0, p1); // 调用管道的transform转换函数
            }
            return result;
        };
}

self._pipe_repeat_6 = new jit_RepeatPipe18(); // 创建RepeatPipe对象
self._pipe_repeat_6_0  = jit_pureProxy214( // 代理RepeatPipe中transform函数
  self._pipe_repeat_6.transform.bind(self._pipe_repeat_6));

2.5.2 管道的执行

在 Angular 执行变化检测时,会自动调用管道中的 transform 方法

var currVal_100 = jit_inlineInterpolate21(1,'',valUnwrapper.unwrap(
  jit_castByValue22 (self._pipe_repeat_6_0,
   self._pipe_repeat_6.transform)('lo',3)),'');

总结

本文介绍了 Angular 2 中的常用内建管道的用法和管道的分类,同时也介绍了 pure 和 impure 管道的区别。 此外我们通过两个示例展示了如何自定义管道,最后详细分析了 RepeatPipe 管道的工作原理。建议读者更改 RepeatePipe 的 pure 属性为 false,体验一下 impure 管道。

你可能感兴趣的:(angular2,angular.js,typescript)