Angular入门系列 第四章:创建特性组件

创建特性组件

本文参考自Angular中文网,原文链接:https://angular.cn/tutorial/toh-pt3

主从组件
此刻,HeroesComponent 同时显示了英雄列表和所选英雄的详情。

把所有特性都放在同一个组件中,将会使应用“长大”后变得不可维护。 你要把大型组件拆分成小一点的子组件,每个子组件都要集中精力处理某个特定的任务或工作流。

本页面中,你将迈出第一步 —— 把英雄详情移入一个独立的、可复用的 HeroDetailComponent

HeroesComponent 将仅仅用来表示英雄列表。 HeroDetailComponent 将用来表示所选英雄的详情。

制作 HeroDetailComponent

使用 Angular CLI 生成一个名叫 hero-detail 的新组件。

ng generate component hero-detail

Angular入门系列 第四章:创建特性组件
这个命令会做这些事:

  • 创建目录 src/app/hero-detail
  • 在这个目录中会生成四个文件:
  • 作为组件样式的 CSS 文件。
  • 作为组件模板的 HTML 文件。
  • 存放组件类 HeroDetailComponentTypeScript 文件。
  • HeroDetailComponent 类的测试文件。

该命令还会把 HeroDetailComponent 添加到 src/app/app.module.ts 文件中 @NgModuledeclarations 列表中。

编写模板

HeroesComponent 模板的底部把表示英雄详情的 HTML 代码剪切粘贴到所生成的 HeroDetailComponent 模板中。

所粘贴的 HTML 引用了 selectedHero。 新的 HeroDetailComponent 可以展示任意英雄,而不仅仅所选的。因此还要把模板中的所有 selectedHero 替换为 hero

完工之后,HeroDetailComponent 的模板应该是这样的:
src/app/hero-detail/hero-detail.component.html

<div *ngIf="hero">

  <h2>{{hero.name | uppercase}} Details</h2>
  <div><span>id: </span>{{hero.id}}</div>
  <div>
    <label>name:
      <input [(ngModel)]="hero.name" placeholder="name"/>
    </label>
  </div>

</div>
添加 @Input() hero 属性

HeroDetailComponent 模板中绑定了组件中的 hero 属性,它的类型是 Hero

打开 HeroDetailComponent 类文件,并导入 Hero 符号。
src/app/hero-detail/hero-detail.component.ts (import Hero)

import { Hero } from '../hero';

hero 属性必须是一个带有 @Input() 装饰器的输入属性,因为外部的 HeroesComponent 组件将会绑定到它。就像这样:

<app-hero-detail [hero]="selectedHero"></app-hero-detail>

修改 @angular/core 的导入语句,导入 Input 符号。
src/app/hero-detail/hero-detail.component.ts (import Input)

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

添加一个带有 @Input() 装饰器的 hero 属性。
src/app/hero-detail/hero-detail.component.ts

export class HeroDetailComponent implements OnInit {
  @Input() hero: Hero;
  constructor() { }

  ngOnInit(): void {
  }

我这里使用的编译器显示 hero 报错,不过保存后页面可以正常显示,页面的控制台没有报错,暂时忽略报错继续做下去。
报错如下:
Angular入门系列 第四章:创建特性组件

详细报错信息如下:
Property 'hero' has no initializer and is not definitely assigned in the constructor.ts(2564)
暂时忽略报错继续做下去。

这就是你要对 HeroDetailComponent 类做的唯一一项修改。 没有其它属性,也没有展示逻辑。这个组件所做的只是通过 hero 属性接收一个英雄对象,并显示它。

显示 HeroDetailComponent

HeroesComponent 仍然是主从视图。

在你从模板中剪切走代码之前,它自己负责显示英雄的详情。现在它要把这个职责委托给 HeroDetailComponent 了。

这两个组件将会具有父子关系。 当用户从列表中选择了某个英雄时,父组件 HeroesComponent 将通过把要显示的新英雄发送给子组件 HeroDetailComponent,来控制子组件。

你不用修改 HeroesComponent 类,但是要修改它的模板。

修改 HeroesComponent 的模板

HeroDetailComponent 的选择器是 'app-hero-detail'。 把 <app-hero-detail> 添加到 HeroesComponent 模板的底部,以便把英雄详情的视图显示到那里。

HeroesComponent.selectedHero 绑定到该元素的 hero 属性,就像这样:
heroes.component.html (HeroDetail binding)

<app-hero-detail [hero]="selectedHero"></app-hero-detail>

[hero]="selectedHero" 是 Angular 的属性绑定语法。

这是一种单向数据绑定。从 HeroesComponentselectedHero 属性绑定到目标元素的 hero 属性,并映射到了 HeroDetailComponenthero 属性。

现在,当用户在列表中点击某个英雄时,selectedHero 就改变了。 当 selectedHero 改变时,属性绑定会修改 HeroDetailComponenthero 属性,HeroDetailComponent 就会显示这个新的英雄。

修改后的 HeroesComponent 的模板是这样的:
heroes.component.html

<h2>My Heroes</h2>

<ul class="heroes">
  <li *ngFor="let hero of heroes"
    [class.selected]="hero === selectedHero"
    (click)="onSelect(hero)">
    <span class="badge">{{hero.id}}</span> {{hero.name}}
  </li>
</ul>

<app-hero-detail [hero]="selectedHero"></app-hero-detail>

浏览器刷新,应用又像以前一样开始工作了。

有哪些变化?

像以前一样,一旦用户点击了一个英雄的名字,该英雄的详情就显示在了英雄列表下方。 现在,HeroDetailComponent 负责显示那些详情,而不再是 HeroesComponent

把原来的 HeroesComponent 重构成两个组件带来了一些优点,无论是现在还是未来:

你通过缩减 HeroesComponent 的职责简化了该组件。

你可以把 HeroDetailComponent 改进成一个功能丰富的英雄编辑器,而不用改动父组件 HeroesComponent

你可以改进 HeroesComponent,而不用改动英雄详情视图。

将来你可以在其它组件的模板中重复使用 HeroDetailComponent

查看最终代码

本页讨论的代码文件如下。
src/app/hero-detail/hero-detail.component.ts

import { Component, OnInit, Input } from '@angular/core';
import { Hero } from '../hero';

@Component({
  selector: 'app-hero-detail',
  templateUrl: './hero-detail.component.html',
  styleUrls: ['./hero-detail.component.css']
})
export class HeroDetailComponent implements OnInit {
  @Input() hero: Hero;

  constructor() { }

  ngOnInit() {
  }

}

src/app/hero-detail/hero-detail.component.html

<div *ngIf="hero">

  <h2>{{hero.name | uppercase}} Details</h2>
  <div><span>id: </span>{{hero.id}}</div>
  <div>
    <label>name:
      <input [(ngModel)]="hero.name" placeholder="name"/>
    </label>
  </div>

</div>

src/app/heroes/heroes.component.html

<h2>My Heroes</h2>

<ul class="heroes">
  <li *ngFor="let hero of heroes"
    [class.selected]="hero === selectedHero"
    (click)="onSelect(hero)">
    <span class="badge">{{hero.id}}</span> {{hero.name}}
  </li>
</ul>

<app-hero-detail [hero]="selectedHero"></app-hero-detail>

src/app/app.module.ts

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { FormsModule } from '@angular/forms';

import { AppComponent } from './app.component';
import { HeroesComponent } from './heroes/heroes.component';
import { HeroDetailComponent } from './hero-detail/hero-detail.component';

@NgModule({
  declarations: [
    AppComponent,
    HeroesComponent,
    HeroDetailComponent
  ],
  imports: [
    BrowserModule,
    FormsModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

小结

  • 创建了一个独立的、可复用的 HeroDetailComponent 组件。
  • 用属性绑定语法来让父组件 HeroesComponent 可以控制子组件 HeroDetailComponent。
  • 用 @Input 装饰器来让 hero 属性可以在外部的 HeroesComponent 中绑定。

上一章:显示英雄列表
下一章:添加服务


上一篇:都说知道 HashMap 线程不安全,那它为啥就不安全?


下一篇:JsonResponse类的使用、form表单上传文件补充、CBV和FBV、HTML的模板语法之传值与过滤器