Components are the main building block for Angular applications. Each component consists of:
This topic describes how to create and configure an Angular component.
To view or download the example code used in this topic, see the live example.
To create a component, verify that you have met the following prerequisites:
ng new <project-name>
, where <project-name>
is the name of your Angular application.The easiest way to create a component is with the Angular CLI. You can also create a component manually.
To create a component using the Angular CLI:
ng generate component <component-name>
command, where <component-name>
is the name of your new component.By default, this command creates the following:
<component-name>.component.ts
<component-name>.component.html
<component-name>.component.css
<component-name>.component.spec.ts
Where <component-name>
is the name of your component.
You can change how
ng generate component
creates new components. For more information, see ng generate component in the Angular CLI documentation.
Although the Angular CLI is the easiest way to create an Angular component, you can also create a component manually. This section describes how to create the core component file within an existing Angular project.
To create a new component manually:
Navigate to your Angular project directory.
Create a new file, <component-name>.component.ts
.
At the top of the file, add the following import statement.
import { Component } from '@angular/core';
After the import
statement, add a @Component
decorator.
@Component({ })
Choose a CSS selector for the component.
@Component({ selector: 'app-component-overview', })
For more information on choosing a selector, see Specifying a component's selector.
Define the HTML template that the component uses to display information. In most cases, this template is a separate HTML file.
@Component({ selector: 'app-component-overview', templateUrl: './component-overview.component.html', })
For more information on defining a component's template, see Defining a component's template.
Select the styles for the component's template. In most cases, you define the styles for your component's template in a separate file.
@Component({ selector: 'app-component-overview', templateUrl: './component-overview.component.html', styleUrls: ['./component-overview.component.css'] })
Add a class
statement that includes the code for the component.
export class ComponentOverviewComponent { }
Every component requires a CSS selector. A selector instructs Angular to instantiate this component wherever it finds the corresponding tag in template HTML. For example, consider a component hello-world.component.ts
that defines its selector as app-hello-world
. This selector instructs Angular to instantiate this component any time the tag <app-hello-world>
appears in a template.
Specify a component's selector by adding a selector
statement to the @Component
decorator.
@Component({ selector: 'app-component-overview', })
A template is a block of HTML that tells Angular how to render the component in your application. You can define a template for your component in one of two ways: by referencing an external file, or directly within the component.
To define a template as an external file, add a templateUrl
property to the @Component
decorator.
@Component({ selector: 'app-component-overview', templateUrl: './component-overview.component.html', })
To define a template within the component, add a template
property to the @Component
decorator that contains the HTML you want to use.
@Component({ selector: 'app-component-overview', template: '<h1>Hello World!</h1>', })
If you want your template to span multiple lines, you can use backticks ( `
). For example:
@Component({ selector: 'app-component-overview', template: `<h1>Hello World!</h1> <p>This template definition spans multiple lines.</p>` })
An Angular component requires a template defined using
template
ortemplateUrl
. You cannot have both statements in a component.
You can declare component styles uses for its template in one of two ways: by referencing an external file, or directly within the component.
To declare the styles for a component in a separate file, add a styleUrls
property to the @Component
decorator.
@Component({ selector: 'app-component-overview', templateUrl: './component-overview.component.html', styleUrls: ['./component-overview.component.css'] })
To declare the styles within the component, add a styles
property to the @Component
decorator that contains the styles you want to use.
@Component({ selector: 'app-component-overview', template: '<h1>Hello World!</h1>', styles: ['h1 { font-weight: normal; }'] })
The styles
property takes an array of strings that contain the CSS rule declarations.
© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v11.angular.io/guide/component-overview