组件是 Angular 应用的主要构造块。每个组件包括如下部分:
本主题描述如何创建和配置 Angular 组件。
要查看或下载本主题中使用的范例代码,请参阅 现场演练/ 下载范例。
要创建一个组件,请先验证你是否满足以下先决条件:
ng new <project-name>
创建一个,其中 <project-name>
是你的 Angular 应用的名字。Angular CLI 是用来创建组件的最简途径。你也可以手动创建一个组件。
使用 Angular CLI 创建一个组件:
ng generate component <component-name>
命令,其中 <component-name>
是新组件的名字。默认情况下,该命令会创建以下内容:
<component-name>.component.ts
<component-name>.component.html
<component-name>.component.css
<component-name>.component.spec.ts
其中 <component-name>
是组件的名称。
你可以更改 ng generate component
创建新组件的方式。
虽然 Angular CLI 是创建 Angular 组件的最佳途径,但你也可以手动创建一个组件。本节将介绍如何在现有的 Angular 项目中创建核心组件文件。
要手动创建一个新组件:
<component-name>.component.ts
。import { Component } from '@angular/core';在
import
语句之后,添加一个 @Component
装饰器。 @Component({为组件选择一个 CSS 选择器。
})
@Component({定义组件用以显示信息的 HTML 模板。在大多数情况下,这个模板是一个单独的 HTML 文件。
selector: 'app-component-overview',
})
@Component({为组件的模板选择样式。在大多数情况下,你可以在单独的文件中定义组件模板的样式。
selector: 'app-component-overview',
templateUrl: './component-overview.component.html',
})
@Component({添加一个包含该组件代码
selector: 'app-component-overview',
templateUrl: './component-overview.component.html',
styleUrls: ['./component-overview.component.css']
})
class
语句。 export class ComponentOverviewComponent {
}
每个组件都需要一个 CSS 选择器。选择器会告诉 Angular:当在模板 HTML 中找到相应的标签时,就把该组件实例化在那里。例如,考虑一个组件 hello-world.component.ts
,它的选择器定义为 app-hello-world
。 当 <app-hello-world>
出现在模板中时,这个选择器就会让 Angular 实例化该组件。
在 @Component
装饰器中添加一个 selector
语句来指定组件的选择器。
@Component({
selector: 'app-component-overview',
})
模板是一段 HTML,它告诉 Angular 如何在应用中渲染组件。可以通过以下两种方式之一为组件定义模板:引用外部文件,或直接写在组件内部。
要把模板定义为外部文件,就要把 templateUrl
添加到 @Component
装饰器中。
@Component({
selector: 'app-component-overview',
templateUrl: './component-overview.component.html',
})
要在组件中定义模板,就要把一个 template
属性添加到 @Component
中,该属性的内容是要使用的 HTML。
@Component({
selector: 'app-component-overview',
template: '<h1>Hello World!</h1>',
})
如果你想让模板跨越多行,可以使用反引号( `
)。例如:
@Component({
selector: 'app-component-overview',
template: `
<h1>Hello World!</h1>
<p>This template definition spans multiple lines.</p>
`
})
Angular 组件需要一个用 template
或 templateUrl
定义的模板。但你不能在组件中同时拥有这两个语句。
有两种方式可以为组件的模板声明样式:引用一个外部文件,或直接写在组件内部。
要在单独的文件中声明组件的样式,就要把 styleUrls
属性添加到 @Component
装饰器中。
@Component({
selector: 'app-component-overview',
templateUrl: './component-overview.component.html',
styleUrls: ['./component-overview.component.css']
})
要想在组件内部声明样式,就要把 styles
属性添加到 @Component
,该属性的内容是你要用的样式。
@Component({
selector: 'app-component-overview',
template: '<h1>Hello World!</h1>',
styles: ['h1 { font-weight: normal; }']
})
styles
属性接受一个包含 CSS 规则的字符串数组。