📖1. The hero editor

The application now has a basic title. Next, create a new component to display hero information and place that component in the application shell.

For the sample application that this page describes, see the live example / download example.

Create the heroes component

Use ng generate to create a new component named heroes.

ng generate component heroes

ng generate creates a new directory , src/app/heroes/, and generates the three files of the HeroesComponent along with a test file.

The HeroesComponent class file is as follows:

app/heroes/heroes.component.ts (initial version)

import { Component } from '@angular/core';

@Component({
  selector: 'app-heroes',
  templateUrl: './heroes.component.html',
  styleUrls: ['./heroes.component.css'],
  standalone: true,
})
export class HeroesComponent {
}

You always import the Component symbol from the Angular core library and annotate the component class with @Component.

@Component is a decorator function that specifies the Angular metadata for the component.

ng generate created three metadata properties:

PROPERTIES	DETAILS
selector	The component's CSS element selector.
templateUrl	The location of the component's template file.
styleUrls	The location of the component's private CSS styles.

The CSS element selector, 'app-heroes', matches the name of the HTML element that identifies this component within a parent component's template.

Always export the component class so you can import it elsewhere … like in the AppModule.

Add a hero property

Add a hero property to the HeroesComponent for a hero named, Windstorm.

heroes.component.ts (hero property)

hero = 'Windstorm';

Show the hero

Open the heroes.component.html template file. Delete the default text that ng generate created and replace it with a data binding to the new hero property.

heroes.component.html

<h2>{{hero}}</h2>

Show the HeroesComponent view

To display the HeroesComponent, you must add it to the template of the shell AppComponent.

Remember that app-heroes is the element selector for the HeroesComponent. Add an <app-heroes> element to the AppComponent template file, just below the title.

src/app/app.component.html

<h1>{{title}}</h1>
<app-heroes></app-heroes>

If ng serve is still running, the browser should refresh and display both the application title and the hero's name.

Create a Hero interface

A real hero is more than a name.

Create a Hero interface in its own file in the src/app directory . Give it id and name properties.

src/app/hero.ts

export interface Hero {
  id: number;
  name: string;
}

Return to the HeroesComponent class and import the Hero interface.

Refactor the component's hero property to be of type Hero. Initialize it with an id of 1 and the name Windstorm.

The revised HeroesComponent class file should look like this:

src/app/heroes/heroes.component.ts

import {  } from '@angular/core';
import { Hero } from '../hero';

@Component({
  selector: 'app-heroes',
  templateUrl: './heroes.component.html',
  styleUrls: ['./heroes.component.css'],
  standalone: true,
})
export class HeroesComponent {
  hero: Hero = {
    id: 1,
    name: 'Windstorm'
  };
}

The page no longer displays properly because you changed the hero from a string to an object.

Show the hero object

Update the binding in the template to announce the hero's name and show both id and name in a details display like this:

heroes.component.html (HeroesComponent template)

<h2>{{hero.name}} Details</h2>
<div><span>id: </span>{{hero.id}}</div>
<div><span>name: </span>{{hero.name}}</div>

The browser refreshes and displays the hero's information.

Format with the UppercasePipe

Edit the hero.name binding like this:

src/app/heroes/heroes.component.html

<h2>{{hero.name | uppercase}} Details</h2>

The browser refreshes and now the hero's name is displayed in capital letters.

The word uppercase in the interpolation binding after the pipe | character, activates the built-in UppercasePipe.

Pipes are a good way to format strings, currency amounts, dates, and other display data. Angular ships with several built-in pipes, and you can create your own.

Edit the hero

Users should be able to edit the hero's name in an <input> text box.

The text box should both display the hero's name property and update that property as the user types. That means data flows from the component class out to the screen and from the screen back to the class.

To automate that data flow, set up a two-way data binding between the <input> form element and the hero.name property.

Two-way binding

Refactor the details area in the HeroesComponent template so it looks like this:

src/app/heroes/heroes.component.html (HeroesComponent's template)

<div>
  <label for="name">Hero name: </label>
  <input id="name" [(ngModel)]="hero.name" placeholder="name">
</div>

[(ngModel)] is Angular's two-way data binding syntax.

Here it binds the hero.name property to the HTML text box so that data can flow in both directions. Data can flow from the hero.name property to the text box and from the text box back to the hero.name.

The missing FormsModule

Notice that the application stopped working when you added [(ngModel)].

To see the error, open the browser development tools and look in the console for a message like

Template parse errors:
Can't bind to 'ngModel' since it isn't a known property of 'input'.

Although ngModel is a valid Angular directive, it isn't available by default.

It belongs to the optional FormsModule and you must opt in to using it.

src/app/heroes/heroes.component.ts

import { Component } from '@angular/core';
import { Hero } from '../hero';
import { FormsModule } from '@angular/forms'; // <-- NgModel lives here


@Component({
  selector: 'app-heroes',
  templateUrl: './heroes.component.html',
  styleUrls: ['./heroes.component.css'],
  standalone: true,
  imports: [
    BrowserModule,
    FormsModule, // <-- Import the forms module
  ],
})
export class HeroesComponent {
  // ...
}

Final code review

Here are the code files discussed on this page.

src/app/heroes/heroes.component.ts

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

@Component({
  selector: 'app-heroes',
  templateUrl: './heroes.component.html',
  styleUrls: ['./heroes.component.css'],
  standalone: true,
  imports: [
    BrowserModule,
    FormsModule,
  ],
})
export class HeroesComponent {
  hero: Hero = {
    id: 1,
    name: 'Windstorm'
  };
}

src/app/heroes/heroes.component.html

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

src/app/app.component.ts

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.scss'],
    standalone: true,
    imports: [RouterLink, RouterOutlet, MessagesComponent]
})
export class AppComponent {
  title = 'Tour of Heroes';
}

src/app.app.component.html

<h1>{{title}}</h1>
<app-heroes></app-heroes>

src/app/hero.ts

export interface Hero {
  id: number;
  name: string;
}

Summary

• You used ng generate to create a second HeroesComponent.

• You displayed the HeroesComponent by adding it to the AppComponent shell.

• You applied the UppercasePipe to format the name.

• You used two-way data binding with the ngModel directive.

• You learned about the AppModule.

• You imported the FormsModule in the AppModule so that Angular would recognize and apply the ngModel directive.

• You learned the importance of declaring components in the AppModule.

-> Hier geht es weiter

💡Hinweise und Zusatzaufgaben zu Kapitel 1