深入研究 Angular 框架中的装饰 已翻译 100%

oschina 投递于 2017/12/06 16:37 (共 14 段, 翻译完成于 12-07)
阅读 1568
收藏 27
5
加载中

使用Angular(Angular 2 及以上版本)开发程序时,装饰是一个核心概念。还有一个正式的TC39 提案,目前处于阶段2中,该提案期望装饰器能够很快成为JavaScript 的核心语言功能。

回到Angular ,Angular 的内部代码广泛使用了装饰器,本篇文章中我们将学习不同类型的装饰器和它们的源码并且了解它们是如何工作的。

我第一次接触到TypeScript 和装饰器的时候,我不知道我为什么需要它们,但是当你稍微往深处发掘的时候你才能了解到了创建装饰器的好处(不仅是在Angular 中)。

在AngularJS 中没有使用装饰器,而是使用了不同的注册方法——例如用 .component() 方法定义一个组件。那为什么Angular 选择使用装饰器呢?让我们开始探索吧!

rever4433
rever4433
翻译于 2017/12/06 22:05
0

Angular 装饰器

在我们创建装饰器和了解为什么Angular 使用它们之前,我们先看看Angular 提供的不同类型的装饰器。主要右四个类型:

类装饰器,例如@Component 和@NgModule。

属性内部的属性装饰器,例如@Input 和 @Output。

方法内部的方法装饰器,例如@HostListener。

类构造函数中参数的参数装饰器,例如 @Inject

每个装饰器都有一个独特的作用,让我们看几个示例来扩展上面的列表。

rever4433
rever4433
翻译于 2017/12/06 22:23
0

类装饰器

Angular 提供了几个类装饰器。这些是我们用来表示类的意图时使用的顶级装饰器。例如,这些装饰器允许我们告诉Angluar 一个特定的类是一个组件或者是一个组件。装饰器允许我们定义类的意图而不用在类的内部写实际的代码。

一个类中的@Component 和 @NgModule 实例:

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

@Component({
  selector: 'example-component',
  template: '<div>Woo a component!</div>'
})
export class ExampleComponent {
  constructor() {
    console.log('Hey I am a component!');
  }
}

@NgModule({
  imports: [],
  declarations: []
})
export class ExampleModule {
  constructor() {
    console.log('Hey I am a module!');
  }
}

请注意,不管这两个类本身是如何的它们实际上是相同的。在类中不需要任何代码去告知Angluar 这个类是component 还是module。我们需要做的只是修饰这个类,余下的工作交给Angular 就可以了

rever4433
rever4433
翻译于 2017/12/06 22:41
0

属性装饰器

这些可能是第二个最常见的装饰器了。他们允许我们在我们的内部装饰特定的属性 - 一个非常强大的机制。

我们来看看@Input()。想象一下,我们有一个属性,我们想要一个输入绑定。

如果没有装饰器,我们必须在我们的类中定义这个属性,以便TypeScript知道它,然后在其他地方告诉Angular我们有一个属性,我们希望有一个输入方法。

使用装饰器,我们可以简单地将@Input()装饰器放在属性的上方 - Angular的编译器会自动从属性名称创建一个输入绑定并将它们链接起来。

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

@Component({
  selector: 'example-component',
  template: '<div>Woo a component!</div>' }) export class ExampleComponent {
  @Input()
  exampleProperty: string;
}

然后我们通过一个组件属性绑定来传递输入绑定

<example-component
  [exampleProperty]="exampleData"> </example-component>

属性装饰器会在ExampleComponentdefinition内发生“魔术”

在AngularJS 1.x(我打算在这里也使用TypeScript,只是为了声明一个类的属性),我们有一个不同的机制,使用scope或bindToController与指令,并在新的组件方法中bindings:

const exampleComponent = {
  bindings: {
    exampleProperty: '<'   },
  template: `
    <div>Woo a component!</div>
  `,
  controller: class ExampleComponent {
    exampleProperty: string;
    $onInit() {
      // access this.exampleProperty     }
  }
};

angular
  .module('app')
  .component('exampleComponent', exampleComponent);

您可以在上面看到,如果我们扩展,重构或更改组件的API绑定和类内的属性名称,我们有两个单独的属性可以维护。然而,在Angular中,有一个属性exampleProperty被装饰,随着我们的代码库的增长,这个属性更容易更改,维护和追踪。

凉凉_
凉凉_
翻译于 2017/12/07 10:54
0

装饰器方法

装饰器方法与装饰器属性非常相似,但是用来写方法的。 这可以用来在我们的类中修饰特定的方法。 一个很好的例子是@HostListener。 这使我们可以告诉Angular,当我们的主程序发生事件时,我们希望用事件调用装饰的方法。

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

@Component({
  selector: 'example-component',
  template: '<div>Woo a component!</div>' }) export class ExampleComponent {
  @HostListener('click', ['$event'])
  onHostClick(event: Event) {
    // clicked, `event` available   }
}
凉凉_
凉凉_
翻译于 2017/12/07 09:27
0

装饰器参数

装饰器的参数十分有趣。 在将基元注入到构造函数中时,您可能遇到过这些问题,您需要手动通知Angular注入特定的提供程序。

深入挖掘依赖注入(DI),令牌,@Inject和@Injectable,可以看看我以前的文章。

参数装饰器允许我们在我们的类构造函数中修饰参数。 这个例子是@Inject,它让我们告诉Angular我们想要什么参数来启动:

import { Component, Inject } from '@angular/core'; import { MyService } from './my-service';

@Component({
  selector: 'example-component',
  template: '<div>Woo a component!</div>' }) export class ExampleComponent {
  constructor(@Inject(MyService) myService) {
    console.log(myService); // MyService   }
}

由于TypeScript公开接口允许给我们使用元数据,我们实际上并不需要这么做。 我们可以让TypeScript和Angular通过指定要注入的作为参数类型来完成我们的辛苦工作:

import { Component } from '@angular/core'; import { MyService } from './my-service';

@Component({
  selector: 'example-component',
  template: '<div>Woo a component!</div>' }) export class ExampleComponent {
  constructor(myService: MyService) {
    console.log(myService); // MyService   }
}

现在我们已经介绍了我们可以使用的装饰器类型,让我们深入了解他们正在做的事情 - 以及为什么我们需要它们。

凉凉_
凉凉_
翻译于 2017/12/07 10:06
0

创建一个装饰器

如果我们了解一个装饰器实际上正在做什么,然后再研究Angular如何使用它们,它会使事情变得更容易。要做到这一点,我们可以创建一个快速的装饰器示例。

装饰器函数

装饰器实际上只是一个函数,就这么简单,并且随着装饰器的调用而被调用。一个装饰器方法被正在被装饰的方法调用装饰器的值,并且一个类装饰器将被被装饰的类所调用。

让我们快速做一个装饰器,我们可以在课堂上进一步证明这一点。这个装饰器只是简单地把类记录到控制台:

function Console(target) {
  console.log('Our decorated class', target);
}

在这里,我们已经创建了控制台(Angular通常使用大写命名约定),并指定一个名为目标的参数。目标参数实际上是我们装饰的类,这意味着我们现在可以用装饰器来装饰任何类,并在控制台中看到它的输出结果:

@Console class ExampleClass {
  constructor() {
    console.log('Yo!');
  }
}

想要看到实际操作?看看现场演示。

凉凉_
凉凉_
翻译于 2017/12/07 10:21
0

将数据传递给装饰器

当我们在Angular中使用装饰器时,我们传递一些特定于装饰器的配置。

例如,当我们使用@Component时,我们通过一个对象,并使用@HostListener,通过一个字符串作为第一个参数(事件名称,比如'click')和可选的字符串数组(如$事件)被传递到装饰的方法里。

让我们稍微修改我们上面的控制台代码来展示如何使用Angular装饰器。

@Console('Hey!') class ExampleClass {
  constructor() {
    console.log('Yo!');
  }
}


如果我们现在运行这个代码,我们只会得到'Hey!'。这是因为我们的装饰器没有返回给予类的函数。 @Console('Hey!')的输出是无效的。

我们需要调整我们的控制台代码的装饰器,以返回给予类的函数闭包。这样我们都可以从装饰器(在我们的例子中是字符串Hey!)以及类中获得一个值:

function Console(message) {
  // access the "metadata" message   console.log(message);
  // return a function closure, which   // is passed the class as `target`   return function (target) {
    console.log('Our decorated class', target);
  }
}

@Console('Hey!') class ExampleClass {
  constructor() {
    console.log('Yo!');
  }
} // console output: 'Hey!' // console output: 'Our decorated class', class ExampleClass{}...

你可以看到这里的变化。

这是Angular装饰器工作的基础。他们首先获取一个配置值,然后接收类/方法/属性来应用装饰。现在我们对装饰器的功能有了一个简单的了解,我们将介绍Angular如何创建并使用它自己的装饰器。

凉凉_
凉凉_
翻译于 2017/12/07 10:46
0

装饰器实际上做什么

每种类型的装饰器共享相同的核心功能。 从纯粹的装饰角度来看,@Component和@Directive都以相同的方式工作,就像@Input和@Output一样。 Angular通过使用每种类型的装饰器的工厂方法来实现这一点。

让我们来看看Angular中最常见的装饰器@Component。

我们不打算用Angular创建这些装饰器的详细代码,因为我们只需要在更高的思维层面上理解它们就就可以了。

凉凉_
凉凉_
翻译于 2017/12/07 09:31
0
本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接。
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
加载中

评论(4)

Raphael_goh
Raphael_goh

引用来自“yak”的评论

ng2组件之间通信用什么?
当然是rxjs啦
yak
yak
ng2组件之间通信用什么?
renwofei423
renwofei423
好文收藏~
ZigzagV
ZigzagV
前端aop典范
返回顶部
顶部