管理数据
Try it: Manage data
在应用内导航的末尾,本应用实现了一个包含两个视图的商品名录:商品列表和商品详情。用户点击清单中的某个商品名称,就会在新视图中看到具有专门的 URL 或路由的详情页。
At the end of In-app Navigation, the online store application has a product catalog with two views: a product list and product details. Users can click on a product name from the list to see details in a new view, with a distinct URL, or route.
本页将指导你分三个步骤创建购物车:
This page guides you through creating the shopping cart in three phases:
修改商品详情视图,让它包含一个 “Buy” 按钮,它会把当前商品添加到由 "购物车服务" 管理的商品列表中。
Update the product details view to include a "Buy" button, which adds the current product to a list of products that a cart service manages.
添加一个购物车组件,它会显示购物车中的商品。
Add a cart component, which displays the items in the cart.
添加一个配送组件,它会使用 Angular 的
HttpClient
从.json
文件中检索配送数据来取得购物车中这些商品的运费。Add a shipping component, which retrieves shipping prices for the items in the cart by using Angular's
HttpClient
to retrieve shipping data from a.json
file.
服务
Services
服务是 Angular 应用的重要组成部分。在 Angular 中,服务是一个类的实例,它可以借助 Angular 的依赖注入系统来让应用中的任何一个部件都能使用它。
Services are an integral part of Angular applications. In Angular, a service is an instance of a class that you can make available to any part of your application using Angular's dependency injection system.
服务可以让你在应用的各个部件之间共享数据。对于在线商店,购物车服务就是存放购物车的数据和方法的地方。
Services are the place where you share data between parts of your application. For the online store, the cart service is where you store your cart data and methods.
创建购物车服务
Create the shopping cart service
到目前为止,用户可以查看商品信息、模拟共享,并接收商品变化的通知。但是,无法购买商品。
Up to this point, users can view product information, and simulate sharing and being notified about product changes. They cannot, however, buy products.
在本节中,你将在商品详情页中添加“Buy”按钮。你还可以设置一个购物车服务来存储购物车中商品的相关信息。
In this section, you add a "Buy" button to the product details view and set up a cart service to store information about products in the cart.
本教程稍后的部分,使用表单接收用户输入会指引你从用户的结账视图中访问这个购物车服务。
A later part of this tutorial, Use forms for user input, guides you through accessing this cart service from the view where the user checks out.
定义购物车服务
Define a cart service
要想生成购物车服务,请右键单击
app
文件夹,选择Angular Generator
,并选择Service
。把这个新服务命名为cart
。To generate a cart service, right click on the
app
folder, chooseAngular Generator
, and chooseService
. Name the new servicecart
.src/app/cart.service.ts import { Injectable } from '@angular/core'; @Injectable({ providedIn: 'root' }) export class CartService { constructor() {} }
StackBlitz 可能会默认在
app.module.ts
中提供购物车服务。那种方式与这个例子里不同,这里使用了打包优化技巧,也就是@Injectable()
的{provedIn:'root'}
语句。 欲知这些服务的详情,参见服务与依赖注入简介。The StackBlitz generator might provide the cart service in
app.module.ts
by default. That differs from the example, which uses a bundle-optimization technique, an@Injectable()
decorator with the{ providedIn: 'root' }
statement. For more information about services, see Introduction to Services and Dependency Injection.在
CartService
类中,定义一个items
属性来把当前商品的数组存储在购物车中。In the
CartService
class, define anitems
property to store the array of the current products in the cart.src/app/cart.service.ts export class CartService { items = []; }
定义把商品添加到购物车、返回购物车商品以及清除购物车商品的方法:
Define methods to add items to the cart, return cart items, and clear the cart items:
src/app/cart.service.ts export class CartService { items = []; addToCart(product) { this.items.push(product); } getItems() { return this.items; } clearCart() { this.items = []; return this.items; } }
addToCart()
方法会将产品附加到items
数组中。The
addToCart()
method appends a product to an array ofitems
.getItems()
方法会收集用户加到购物车中的商品,并返回每个商品及其数量。The
getItems()
method collects the items users add to the cart and returns each item with its associated quantity.clearCart()
方法返回一个空数组。The
clearCart()
method returns an empty array of items.
使用购物车服务
Use the cart service
本节会教你通过 “Buy” 按钮使用购物车服务来把商品添加到购物车。
This section walks you through using the cart service to add a product to the cart with a "Buy" button.
打开
product-details.component.ts
。Open
product-details.component.ts
.配置该组件,使其能使用这个购物车服务。
Configure the component to use the cart service.
导入购物车服务。
Import the cart service.
src/app/product-details/product-details.component.ts import { Component, OnInit } from '@angular/core'; import { ActivatedRoute } from '@angular/router'; import { products } from '../products'; import { CartService } from '../cart.service';
通过把购物车服务注入到这里的
constructor()
中来注入它。Inject the cart service by adding it to the
constructor()
.src/app/product-details/product-details.component.ts export class ProductDetailsComponent implements OnInit { constructor( private route: ActivatedRoute, private cartService: CartService ) { } }
定义
addToCart()
方法,该方法会当前商品添加到购物车中。Define the
addToCart()
method, which adds the current product to the cart.addToCart()
方法会做下面这三件事:The
addToCart()
method does the following three things:接收当前的
product
。Receives the current
product
.使用购物车服务的
addToCart()
方法把该商品添加到购物车中。Uses the cart service's
addToCart()
method to add the product the cart.显示一条消息,表明你已经把一个商品加入了购物车。
Displays a message that you've added a product to the cart.
src/app/product-details/product-details.component.ts export class ProductDetailsComponent implements OnInit { addToCart(product) { this.cartService.addToCart(product); window.alert('Your product has been added to the cart!'); } }
修改商品详情模板,让它具有一个“Buy”按钮,用于把当前商品添加到购物车中。
Update the product details template with a "Buy" button that adds the current product to the cart.
打开
product-details.component.html
。Open
product-details.component.html
.添加一个标签为“Buy”的按钮,并把其
click()
事件绑定到addToCart()
方法:Add a button with the label "Buy", and bind the
click()
event to theaddToCart()
method:src/app/product-details/product-details.component.html <h2>Product Details</h2> <div *ngIf="product"> <h3>{{ product.name }}</h3> <h4>{{ product.price | currency }}</h4> <p>{{ product.description }}</p> <button (click)="addToCart(product)">Buy</button> </div>
<h4>{{ product.price | currency }}</h4>
折行使用了currency
管道将product.price
从数字转换为货币字符串。管道是一种可以在 HTML 模板中转换数据的方法。有关 Angular 管道的更多信息,参见管道。The line,
<h4>{{ product.price | currency }}</h4>
uses thecurrency
pipe to transformproduct.price
from a number to a currency string. A pipe is a way you can transform data in your HTML template. For more information about Angular pipes, see Pipes.
要查看新的“Buy”按钮,请刷新应用并单击商品名称以显示其详细信息。
To see the new "Buy" button, refresh the application and click on a product's name to display its details.
点击“Buy”按钮来把该商品添加到购物车中存储的商品列表中,并显示一条确认消息。
Click the "Buy" button to add the product to the stored list of items in the cart and display a confirmation message.
创建购物车视图
Create the cart view
此时,用户可以通过点击“Buy”来把商品放入购物车,但他们还看不到购物车。
At this point, users can put items in the cart by clicking "Buy", but they can't yet see their cart.
分两步创建购物车视图:
Create the cart view in two steps:
创建一个购物车组件并配置指向这个新组件的路由。此时,购物车视图只会显示默认文本。
Create a cart component and configure routing to the new component. At this point, the cart view has only default text.
显示购物车商品
Display the cart items.
设置该组件
Set up the component
要创建购物车视图,首先要执行与创建商品详情组件相同的步骤,并为这个新组件设置路由。
To create the cart view, begin by following the same steps you did to create the product details component and configure routing for the new component.
生成一个名叫
cart
的购物车组件。Generate a cart component, named
cart
.提示:在文件列表框中,右键单击
app
文件夹,选择Angular Generator
和Component
。Reminder: In the file list, right-click the
app
folder, chooseAngular Generator
andComponent
.src/app/cart/cart.component.ts import { Component, OnInit } from '@angular/core'; @Component({ selector: 'app-cart', templateUrl: './cart.component.html', styleUrls: ['./cart.component.css'] }) export class CartComponent implements OnInit { constructor() { } ngOnInit() { } }
为购物车组件添加路由(URL 模式)。
Add routing (a URL pattern) for the cart component.
打开
app.module.ts
,为组件CartComponent
添加一个路由,其路由为cart
:Open
app.module.ts
and add a route for the componentCartComponent
, with apath
ofcart
:src/app/app.module.ts @NgModule({ imports: [ BrowserModule, ReactiveFormsModule, RouterModule.forRoot([ { path: '', component: ProductListComponent }, { path: 'products/:productId', component: ProductDetailsComponent }, { path: 'cart', component: CartComponent }, ]) ],
修改 "Checkout" 按钮,以便让它路由到
/cart
。Update the "Checkout" button so that it routes to the
/cart
url.打开
top-bar.component.html
并添加一个指向/cart
的routerLink
指令。Open
top-bar.component.html
and add arouterLink
directive pointing to/cart
.src/app/top-bar/top-bar.component.html <a routerLink="/cart" class="button fancy-button"> <i class="material-icons">shopping_cart</i>Checkout </a>
要查看新的购物车组件,请点击“Checkout”按钮。你会看到默认文本“cart works!”,该 URL 的格式为
https://getting-started.stackblitz.io/cart
,其中的 getting-started.stackblitz.io 部分可能与你的 StackBlitz 项目不同。To see the new cart component, click the "Checkout" button. You can see the "cart works!" default text, and the URL has the pattern
https://getting-started.stackblitz.io/cart
, wheregetting-started.stackblitz.io
may be different for your StackBlitz project.
显示购物车商品
Display the cart items
你可以用服务来跨组件共享数据:
You can use services to share data across components:
商品详情组件已经使用了购物车服务(
CartService
)来把商品添加到购物车中。The product details component already uses the cart service to add products to the cart.
本节将告诉你如何修改购物车组件以使用购物车服务来显示购物车中的商品。
This section shows you how to use the cart service to display the products in the cart.
打开
cart.component.ts
。Open
cart.component.ts
.设置该组件是为了让它能够使用这个购物车服务。(这与你在前面设置商品详情组件以使用购物车服务的方式是一样的。)
Configure the component to use the cart service.
从
cart.service.ts
文件中导入CartService
。Import the
CartService
from thecart.service.ts
file.src/app/cart/cart.component.ts import { Component } from '@angular/core'; import { CartService } from '../cart.service';
注入
CartService
,以便购物车组件可以使用它。Inject the
CartService
so that the cart component can use it.src/app/cart/cart.component.ts export class CartComponent { constructor( private cartService: CartService ) { } }
定义
items
属性,以便把商品存放在购物车中。Define the
items
property to store the products in the cart.src/app/cart/cart.component.ts export class CartComponent { items; constructor( private cartService: CartService ) { } }
使用购物车服务的
getItems()
方法设置这些商品。回想一下,你在生成cart.service.ts
时定义过这个方法。Set the items using the cart service's
getItems()
method. Recall that you defined this method when you generatedcart.service.ts
.所生成的
CartComponent
类是这样的:The resulting
CartComponent
class is as follows:src/app/cart/cart.component.ts export class CartComponent implements OnInit { items; constructor( private cartService: CartService ) { } ngOnInit() { this.items = this.cartService.getItems(); } }
修改模板,加上标题,用带有
*ngFor
的<div>
来显示每个购物车商品的名字和价格。Update the template with a header, and use a
<div>
with an*ngFor
to display each of the cart items with its name and price.生成的
CartComponent
模板如下:The resulting
CartComponent
template is as follows:src/app/cart/cart.component.html <h3>Cart</h3> <div class="cart-item" *ngFor="let item of items"> <span>{{ item.name }}</span> <span>{{ item.price | currency }}</span> </div>
测试你的购物车组件。
Test your cart component.
点击“My Store”,进入商品列表视图。
Click on "My Store" to go to the product list view.
单击商品名称以显示其详细信息。
Click on a product name to display its details.
点击“Buy”,即可将商品添加到购物车。
Click "Buy" to add the product to the cart.
点击“Checkout”查看购物车。
Click "Checkout" to see the cart.
要添加其它商品,请点击“My Store”返回商品列表。
To add another product, click "My Store" to return to the product list.
重复上述步骤来添加更多条目。
Repeat to add more items to the cart.
StackBlitz 提示:只要预览刷新,就会清除购物车。如果你对该应用进行了更改,视图就会刷新,你需要重新购买商品来填充购物车。
StackBlitz tip: Any time the preview refreshes, the cart is cleared. If you make changes to the app, the page refreshes, so you'll need to buy products again to populate the cart.
要了解关于服务的更多信息,请参阅“服务和依赖注入简介”。
For more information about services, see Introduction to Services and Dependency Injection.
检索运费价格
Retrieve shipping prices
服务器通常采用流的形式返回数据。 流是很有用的,因为它们可以很容易地转换返回的数据,也可以修改你请求数据的方式。 Angular 的 HTTP 客户端( HttpClient
)是一种内置的方式,可以从外部 API 中获取数据,并以流的形式提供给你的应用。
Servers often return data in the form of a stream. Streams are useful because they make it easy to transform the returned data and make modifications to the way you request that data. The Angular HTTP client, HttpClient
, is a built-in way to fetch data from external APIs and provide them to your app as a stream.
本节会为你展示如何使用 HTTP 客户端从外部文件中检索运费。
This section shows you how to use the HTTP client to retrieve shipping prices from an external file.
预定义的配送数据
Predefined shipping data
在本指南的 StackBlitz 应用中,通过 assets/shipping.json
文件提供了一些预定义的配送数据。你可以利用这些数据为购物车中的商品添加运费。
The application that StackBlitz generates for this guide comes with predefined shipping data in assets/shipping.json
. Use this data to add shipping prices for items in the cart.
[
{
"type": "Overnight",
"price": 25.99
},
{
"type": "2-Day",
"price": 9.99
},
{
"type": "Postal",
"price": 2.99
}
]
在 AppModule
中为应用启用 HttpClient
Use HttpClient
in the AppModule
在使用 Angular 的 HTTP 客户端之前,你必须先配置你的应用来使用 HttpClientModule
。
Before you can use Angular's HTTP client, you must configure your app to use HttpClientModule
.
Angular 的 HttpClientModule
中注册了在整个应用中使用 HttpClient
服务的单个实例所需的服务提供者。
Angular's HttpClientModule
registers the providers your app needs to use a single instance of the HttpClient
service throughout your app.
打开
app.module.ts
。Open
app.module.ts
.该文件包含可供整个应用使用的导入对象和功能。
This file contains imports and functionality that is available to the entire app.
在该文件的顶部从
@angular/common/http
包中导入HttpClientModule
以及其它导入项。 由于有很多其它导入项,因此这里的代码片段省略它们,以保持简洁。请确保现有的导入都还在原地。Import
HttpClientModule
from the@angular/common/http
package at the top of the file with the other imports. As there are a number of other imports, this code snippet omits them for brevity. Be sure to leave the existing imports in place.src/app/app.module.ts import { HttpClientModule } from '@angular/common/http';
把
HttpClientModule
添加到AppModule
@NgModule()
的imports
数组中,以便全局注册 Angular 的HttpClient
。Add
HttpClientModule
to theAppModule
@NgModule()
imports
array to register Angular'sHttpClient
providers globally.src/app/app.module.ts @NgModule({ imports: [ BrowserModule, HttpClientModule, ReactiveFormsModule, RouterModule.forRoot([ { path: '', component: ProductListComponent }, { path: 'products/:productId', component: ProductDetailsComponent }, { path: 'cart', component: CartComponent }, ]) ], declarations: [ AppComponent, TopBarComponent, ProductListComponent, ProductAlertsComponent, ProductDetailsComponent, CartComponent, ], bootstrap: [ AppComponent ] }) export class AppModule { }
在购物车服务中使用 HttpClient
Use HttpClient
in the cart service
AppModule
已经导入了 HttpClientModule
,接下来就是将 HttpClient
服务注入到你的服务中,以便此应用可以获取数据并与外部 API 和资源进行交互。
Now that the AppModule
imports the HttpClientModule
, the next step is to inject the HttpClient
service into your service so your app can fetch data and interact with external APIs and resources.
打开
cart.service.ts
。Open
cart.service.ts
.从
@angular/common/http
包中导入HttpClient
。Import
HttpClient
from the@angular/common/http
package.src/app/cart.service.ts import { Injectable } from '@angular/core'; import { HttpClient } from '@angular/common/http';
把
HttpClient
注入到CartService
的构造函数中:Inject
HttpClient
into theCartService
constructor:src/app/cart.service.ts export class CartService { items = []; constructor( private http: HttpClient ) {} }
定义 get()
方法
Define the get()
method
多个组件可以使用同一个服务。在这个教程的后半部分,商品配送组件使用该购物车服务从 shipping.json
文件中借助 HTTP 检索配送数据。 首先要定义一个 get()
方法。
Multiple components can leverage the same service. Later in this tutorial, the shipping component uses the cart service to retrieve shipping data via HTTP from the shipping.json
file. First, define a get()
method.
继续在
cart.service.ts
中工作。Continue working in
cart.service.ts
.在
clearCart()
方法下面,定义一个新的getShippingPrices()
方法,该方法使用HttpClient#get()
方法检索配送数据(类型和价格)。Below the
clearCart()
method, define a newgetShippingPrices()
method that uses theHttpClient
get()
method to retrieve the shipping data.src/app/cart.service.ts export class CartService { items = []; constructor( private http: HttpClient ) {} addToCart(product) { this.items.push(product); } getItems() { return this.items; } clearCart() { this.items = []; return this.items; } getShippingPrices() { return this.http.get('/assets/shipping.json'); } }
要了解关于 Angular HttpClient
的更多信息,请参阅客户端-服务器集成指南。
For more information about Angular's HttpClient
, see the Client-Server Interaction guide.
定义配送视图
Define the shipping view
现在你的应用已经可以检索配送数据了,你还要创建一个配送组件和相关的模板。
Now that your app can retrieve shipping data, create a shipping component and template.
生成一个名为
shipping
的新组件。Generate a new component named
shipping
.提示:在文件列表框中,右键单击
app
文件夹,选择Angular Generator
和Component
。Reminder: In the file list, right-click the
app
folder, chooseAngular Generator
andComponent
.src/app/shipping/shipping.component.ts import { Component, OnInit } from '@angular/core'; @Component({ selector: 'app-shipping', templateUrl: './shipping.component.html', styleUrls: ['./shipping.component.css'] }) export class ShippingComponent implements OnInit { constructor() { } ngOnInit() { } }
在
app.module.ts
中,添加一个配送路由。其path
为shipping
,其 component 为ShippingComponent
。In
app.module.ts
, add a route for shipping. Specify apath
ofshipping
and a component ofShippingComponent
.src/app/app.module.ts @NgModule({ imports: [ BrowserModule, HttpClientModule, ReactiveFormsModule, RouterModule.forRoot([ { path: '', component: ProductListComponent }, { path: 'products/:productId', component: ProductDetailsComponent }, { path: 'cart', component: CartComponent }, { path: 'shipping', component: ShippingComponent }, ]) ], declarations: [ AppComponent, TopBarComponent, ProductListComponent, ProductAlertsComponent, ProductDetailsComponent, CartComponent, ShippingComponent ], bootstrap: [ AppComponent ] }) export class AppModule { }
新的配送组件尚未链接到任何其它组件,但你可以通过输入其路由指定的 URL 在预览窗格中看到它的模板。该 URL 具有以下模式:
https://getting-started.stackblitz.io/shipping
,其中的 gets-started.stackblitz.io 部分可能与你的 StackBlitz 项目不同。There's no link to the new shipping component yet, but you can see its template in the preview pane by entering the URL its route specifies. The URL has the pattern:
https://getting-started.stackblitz.io/shipping
where thegetting-started.stackblitz.io
part may be different for your StackBlitz project.修改配送组件,让它利用购物车服务从
shipping.json
文件中通过 HTTP 检索配送数据。Modify the shipping component so that it uses the cart service to retrieve shipping data via HTTP from the
shipping.json
file.导入购物车服务。
Import the cart service.
src/app/shipping/shipping.component.ts import { Component, OnInit } from '@angular/core'; import { CartService } from '../cart.service';
定义
shippingCosts
属性。Define a
shippingCosts
property.src/app/shipping/shipping.component.ts export class ShippingComponent implements OnInit { shippingCosts; }
把购物车服务注入到
ShippingComponent
的构造函数中:Inject the cart service in the
ShippingComponent
constructor:src/app/shipping/shipping.component.ts constructor( private cartService: CartService ) { }
利用购物车服务的
getShippingPrices()
方法设置shippingCosts
属性。Set the
shippingCosts
property using thegetShippingPrices()
method from the cart service.src/app/shipping/shipping.component.ts export class ShippingComponent implements OnInit { shippingCosts; constructor( private cartService: CartService ) { } ngOnInit() { this.shippingCosts = this.cartService.getShippingPrices(); } }
利用
async
管道修改配送组件的模板,以显示配送类型和价格:Update the shipping component's template to display the shipping types and prices using the
async
pipe:src/app/shipping/shipping.component.html <h3>Shipping Prices</h3> <div class="shipping-item" *ngFor="let shipping of shippingCosts | async"> <span>{{ shipping.type }}</span> <span>{{ shipping.price | currency }}</span> </div>
async
管道从数据流中返回最新值,并在所属组件的生命期内持续返回。当 Angular 销毁该组件时,async
管道会自动停止。有关async
管道的详细信息,请参见 AsyncPipe API 文档。The
async
pipe returns the latest value from a stream of data and continues to do so for the life of a given component. When Angular destroys that component, theasync
pipe automatically stops. For detailed information about theasync
pipe , see the AsyncPipe API documentation.在购物车视图中添加一个到配送视图的链接:
Add a link from the cart view to the shipping view:
src/app/cart/cart.component.html <h3>Cart</h3> <p> <a routerLink="/shipping">Shipping Prices</a> </p> <div class="cart-item" *ngFor="let item of items"> <span>{{ item.name }}</span> <span>{{ item.price | currency }}</span> </div>
测试这个运费价格功能:
Test your shipping prices feature:
点击“Checkout”按钮,查看更新后的购物车。(注意,修改应用会导致预览窗格刷新,这会清空购物车。)
Click the "Checkout" button to see the updated cart. Remember that changing the app causes the preview to refresh, which empties the cart.
点击此链接可以导航到运费页。
Click on the link to navigate to the shipping prices.
下一步
Next steps
恭喜!你有一个带有商品名录和购物车的在线商店应用了,而且你还可以查询并显示运费。
Congratulations! You have an online store application with a product catalog and shopping cart. You can also look up and display shipping prices.
要继续探索 Angular,请选择下列选项之一:
To continue exploring Angular, choose either of the following options:
继续浏览“表单”部分,通过添加购物车视图和一个结账表单来完成该应用。
Continue to the "Forms" section to finish the app by adding the shopping cart view and a checkout form.
跳到“部署”部分,把你的应用部署到 Firebase 或转成本地开发。
Skip ahead to the "Deployment" section to move to local development, or deploy your app to Firebase or your own server.