This is the archived documentation for Angular v6. Please visit angular.io to see documentation for the current version of Angular.

The Application Shell

Install the Angular CLI

Install the Angular CLI, if you haven't already done so.

npm install -g @angular/cli 
      
      npm install -g @angular/cli

Create a new application

Create a new project named angular-tour-of-heroes with this CLI command.

ng new angular-tour-of-heroes 
      
      ng new angular-tour-of-heroes

The Angular CLI generated a new project with a default application and supporting files.

You can add pre-packaged functionality to a new project by using the ng add command. The ng add command transforms a project by applying the schematics in the specified package. For more information, see the Angular CLI documentation.

Angular Material provides schematics for typical app layouts. See the Angular Material documentation for details.

Serve the application

Go to the project directory and launch the application.

cd angular-tour-of-heroes ng serve --open 
      
      cd angular-tour-of-heroes
ng serve --open

The ng serve command builds the app, starts the development server, watches the source files, and rebuilds the app as you make changes to those files.

The --open flag opens a browser to http://localhost:4200/.

You should see the app running in your browser.

Angular components

The page you see is the application shell. The shell is controlled by an Angular component named AppComponent.

Components are the fundamental building blocks of Angular applications. They display data on the screen, listen for user input, and take action based on that input.

Change the application title

Open the project in your favorite editor or IDE and navigate to the src/app folder.

You'll find the implementation of the shell AppComponent distributed over three files:

  1. app.component.ts— the component class code, written in TypeScript.
  2. app.component.html— the component template, written in HTML.
  3. app.component.css— the component's private CSS styles.

Open the component class file (app.component.ts) and change the value of the title property to 'Tour of Heroes'.

title = 'Tour of Heroes';
app.component.ts (class title property)
      
      title = 'Tour of Heroes';

Open the component template file (app.component.html) and delete the default template generated by the Angular CLI. Replace it with the following line of HTML.

<h1>{{title}}</h1>
app.component.html (template)
      
      <h1>{{title}}</h1>

The double curly braces are Angular's interpolation binding syntax. This interpolation binding presents the component's title property value inside the HTML header tag.

The browser refreshes and displays the new application title.

Add application styles

Most apps strive for a consistent look across the application. The CLI generated an empty styles.css for this purpose. Put your application-wide styles there.

Here's an excerpt from the styles.css for the Tour of Heroes sample app.

/* Application-wide Styles */ h1 { color: #369; font-family: Arial, Helvetica, sans-serif; font-size: 250%; } h2, h3 { color: #444; font-family: Arial, Helvetica, sans-serif; font-weight: lighter; } body { margin: 2em; } body, input[text], button { color: #888; font-family: Cambria, Georgia; } /* everywhere else */ * { font-family: Arial, Helvetica, sans-serif; }
src/styles.css (excerpt)
      
      
  1. /* Application-wide Styles */
  2. h1 {
  3.   color: #369;
  4.   font-family: Arial, Helvetica, sans-serif;
  5.   font-size: 250%;
  6. }
  7. h2, h3 {
  8.   color: #444;
  9.   font-family: Arial, Helvetica, sans-serif;
  10.   font-weight: lighter;
  11. }
  12. body {
  13.   margin: 2em;
  14. }
  15. body, input[text], button {
  16.   color: #888;
  17.   font-family: Cambria, Georgia;
  18. }
  19. /* everywhere else */
  20. * {
  21.   font-family: Arial, Helvetica, sans-serif;
  22. }

Final code review

The source code for this tutorial and the complete Tour of Heroes global styles are available in the live example / download example.

Here are the code files discussed on this page.

import { Component } from '@angular/core'; @Component({ selector: 'app-root', templateUrl: './app.component.html', styleUrls: ['./app.component.css'] }) export class AppComponent { title = 'Tour of Heroes'; } <h1>{{title}}</h1> /* Application-wide Styles */ h1 { color: #369; font-family: Arial, Helvetica, sans-serif; font-size: 250%; } h2, h3 { color: #444; font-family: Arial, Helvetica, sans-serif; font-weight: lighter; } body { margin: 2em; } body, input[text], button { color: #888; font-family: Cambria, Georgia; } /* everywhere else */ * { font-family: Arial, Helvetica, sans-serif; } 
      
      import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {
  title = 'Tour of Heroes';
}

Summary

  • You created the initial application structure using the Angular CLI.
  • You learned that Angular components display data.
  • You used the double curly braces of interpolation to display the app title.