Angular 欢迎你!
本教程将通过构建一个电子商务网站,向你介绍 Angular 的基本知识。该网站具有商品名录、购物车和结账表单。
为了帮助你更好地起步,本教程提供了一个已完成的应用,你可以在 Stackblitz 上试验及互动,而不用建立本地开发环境。 StackBlitz 是一个基于浏览器的开发环境,你可以在其中使用各种技术来创建、保存和共享项目。
为了充分利用本教程,你应该已经对以下内容有基本的了解。
你可以用组件构建 Angular 应用。组件定义了 UI 中的职责范围,让你可以复用某些 UI 功能集。
一个组件由三部分组成:
本指南演示了如何使用下列组件构建应用。
<app-root>
- 第一个加载的组件,并且是其他组件的容器。<app-top-bar>
- 商店名称和结帐按钮。<app-product-list>
- 产品列表。<app-product-alerts>
- 包含应用中各种通知的组件。要创建范例项目,请在 StackBlitz 中生成一个预置的范例项目。要保存你的工作,请执行以下操作:
在 StackBlitz 中,右侧的预览窗格会显示范例应用的启动状态。此预览有两个区域:
左侧的项目区显示了构成本应用的源文件,包括基础结构和配置文件。
当你生成本教程随附的 StackBlitz 范例应用时,StackBlitz 会为你创建启动程序文件和模拟数据。本教程中用到的文件位于 src
文件夹中。
有关如何使用 StackBlitz 的更多信息,请参见 StackBlitz 的文档。
在本节中,你将修改应用以显示产品列表。你会用到来自 products.ts
文件的预定义产品数据,和一些来自 product-list.component.ts
文件的方法。本节将指导你完成编辑 HTML(也称为模板)的过程。
product-list
文件夹中,打开模板文件 product-list.component.html
。<div>
上添加一个结构型指令 *ngFor
,如下所示。<h2>Products</h2>
<div *ngFor="let product of products">
</div>
使用 *ngFor
,会把这个 <div>
针对列表中的每个产品进行复写。
结构型指令会通过添加、删除和操作元素来调整或重塑 DOM 结构。
在此 <div>
中,添加 <h3>
和 {{ product.name }}
。{{ product.name }}
语句是 Angular 插值语法的范例。插值 {{ }}
可以让你把属性值渲染为文本。 <h2>Products</h2>
<div *ngFor="let product of products">
<h3>
{{ product.name }}
</h3>
</div>
预览窗格将会更新,以显示列表中每个商品的名称。
为了让每个商品名称都能链接到商品详情,请围绕 {{ product.name }}
添加一个 <a>
元素。 使用 [ ]
语法将标题设置为此产品的名称,如下所示: <h2>Products</h2>
<div *ngFor="let product of products">
<h3>
<a [title]="product.name + ' details'">
{{ product.name }}
</a>
</h3>
</div>
在预览窗格中,将鼠标悬停在产品名称上,可以查看所绑定的 name 属性值,该值是产品名加上单词 “details”。通过属性绑定 [ ]
可以在模板表达式中使用属性值。
<p>
元素上使用 *ngIf
指令,以便 Angular 只让当前产品有描述 <p>
<h2>Products</h2>
<div *ngFor="let product of products">
<h3>
<a [title]="product.name + ' details'">
{{ product.name }}
</a>
</h3>
<p *ngIf="product.description">
Description: {{ product.description }}
</p>
</div>
现在,该应用将在列表中显示每个产品的名称和描述。请注意,最后一项产品没有描述段落。Angular 不会创建 <p>
元素,因为此产品的 description 属性为空。
click
事件绑定到 product-list.component.ts
中的 share()
方法。事件绑定要在此事件用一组圆括号 ( )
括起来,就比如 <button>
元素上的 (click)
。 <h2>Products</h2>
<div *ngFor="let product of products">
<h3>
<a [title]="product.name + ' details'">
{{ product.name }}
</a>
</h3>
<p *ngIf="product.description">
Description: {{ product.description }}
</p>
<button (click)="share()">
Share
</button>
</div>
每个产品现在都有一个 “Share” 按钮。
单击 “Share” 按钮将触发一条通知,指出 “The product has been shared!”。
在编辑模板时,你已经了解了 Angular 模板的一些最常用的功能。
目前,产品列表中显示了每个产品的名称和描述。ProductListComponent
还定义了一个 products
属性,包含从 products.ts
的 products
数组导入的各个产品的数据。
下一步是创建一个新的通知功能,该功能会使用来自 ProductListComponent
的产品数据。通知会检查产品的价格,如果价格大于 700 美元,则会显示 Notify Me 按钮,当产品上市销售时,用户可以通过该按钮注册通知。
本节将引导你创建一个子组件 ProductAlertsComponent
,该子组件可以从其父组件 ProductListComponent
接收数据。
product-alerts
的新组件。 ng generate component product-alerts
该生成器会为组件的三个部分创建初始文件:
product-alerts.component.ts
product-alerts.component.html
product-alerts.component.css
product-alerts.component.ts
。@Component()
装饰器会指出它后面的类是组件。@Component()
还会提供有关组件的元数据,包括其选择器、模板和样式。 import { Component, OnInit } from '@angular/core';
@Component({
selector: 'app-product-alerts',
templateUrl: './product-alerts.component.html',
styleUrls: ['./product-alerts.component.css']
})
export class ProductAlertsComponent implements OnInit {
constructor() { }
ngOnInit() {
}
}
@Component()
中的主要功能如下:
selector
(app-product-alerts
)用于标识组件。按照惯例,Angular 组件选择器以前缀 app-
开头,后跟组件名称。@Component()
定义还导出了类 ProductAlertsComponent
,该类会处理组件的功能。ProductAlertsComponent
设置为接收产品数据,请首先从 @angular/core
中导入符号 Input
。 import { Component, OnInit, Input } from '@angular/core';在
import { Product } from '../products';
ProductAlertsComponent
类定义中,使用 @Input()
装饰器定义一个名为 product
的属性。 @Input()
装饰器指出此属性值要从本组件的父组件 ProductListComponent
中传入。 export class ProductAlertsComponent implements OnInit {打开
@Input() product!: Product;
constructor() { }
ngOnInit() {
}
}
product-alerts.component.html
并将占位符段落替换为 Notify Me 按钮,如果产品价格超过 700 美元,就会出现此按钮。 <p *ngIf="product && product.price > 700">生成器会自动把
<button>Notify Me</button>
</p>
ProductAlertsComponent
添加到 AppModule
中,以便它能用于本应用的其它组件中。 import { ProductAlertsComponent } from './product-alerts/product-alerts.component';最后,要将
@NgModule({
declarations: [
AppComponent,
TopBarComponent,
ProductListComponent,
ProductAlertsComponent,
],
ProductAlertsComponent
显示为 ProductListComponent
的子级,请将 <app-product-alerts>
元素添加到 product-list.component.html
中。使用属性绑定将当前产品作为输入传给此组件。 <button (click)="share()">
Share
</button>
<app-product-alerts
[product]="product">
</app-product-alerts>
这个新的产品通知组件将产品作为产品列表中的输入。使用该输入,它将根据产品的价格显示或隐藏 Notify Me 按钮。Phone XL 的价格超过了 700 美元,因此该产品上会显示 Notify Me 按钮。
为了使 Notify Me 按钮起作用,子组件需要通知并将数据传递给父组件。当用户单击 Notify Me 时 ProductAlertsComponent
需要引发一个事件,并且 ProductListComponent
需要响应此事件。
在新建组件时,Angular 生成器会包含一个空的 constructor()
、OnInit
接口和 ngOnInit()
方法。 由于这些步骤不会使用它们,下列范例代码中都省略了它们,以求简洁。
product-alerts.component.ts
中,从 @angular/core
导入符号 Output
和 EventEmitter
。import { Component, Input, Output, EventEmitter } from '@angular/core';在组件类中,使用
import { Product } from '../products';
@Output()
装饰器和 EventEmitter()
的实例定义一个名为 notify
的属性。使用 @Output()
配置 ProductAlertsComponent
,这会让 ProductAlertsComponent
在 notify
属性的值发生变化时引发一个事件。 export class ProductAlertsComponent {在
@Input() product: Product | undefined;
@Output() notify = new EventEmitter();
}
product-alerts.component.html
中,修改 Notify Me 按钮,增加事件绑定,并调用 notify.emit()
方法。 <p *ngIf="product && product.price > 700">定义用户单击按钮时发生的行为。当子组件引发事件时,父组件
<button (click)="notify.emit()">Notify Me</button>
</p>
ProductListComponent
(而不是 ProductAlertsComponent
)会采取行动。在 product-list.component.ts
中,定义一个 onNotify()
方法,类似于 share()
方法。 export class ProductListComponent {更新
products = products;
share() {
window.alert('The product has been shared!');
}
onNotify() {
window.alert('You will be notified when the product goes on sale');
}
}
ProductListComponent
,以从 ProductAlertsComponent
中接收数据。 在 product-list.component.html
中,将 <app-product-alerts>
绑定到产品列表组件的 onNotify()
方法。<app-product-alerts>
会显示 Notify Me 按钮的内容。
<button (click)="share()">单击 Notify Me 按钮以触发一条通知,内容为:"You will be notified when the product goes on sale"。
Share
</button>
<app-product-alerts
[product]="product"
(notify)="onNotify()">
</app-product-alerts>