2017-11-06 13:02:18 -05:00
|
|
|
<h1 class="no-toc">Tutorial: Tour of Heroes</h1>
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-11-06 13:02:18 -05:00
|
|
|
The _Tour of Heroes_ tutorial covers the fundamentals of Angular.
|
|
|
|
In this tutorial you will build an app that helps a staffing agency manage its stable of heroes.
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-11-06 13:02:18 -05:00
|
|
|
This basic app has many of the features you'd expect to find in a data-driven application.
|
|
|
|
It acquires and displays a list of heroes, edits a selected hero's detail, and navigates among different views of heroic data.
|
2017-03-27 11:08:53 -04:00
|
|
|
|
2017-11-06 13:02:18 -05:00
|
|
|
By the end of the tutorial you will be able to do the following:
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-11-06 13:02:18 -05:00
|
|
|
* Use built-in Angular directives to show and hide elements and display lists of hero data.
|
|
|
|
* Create Angular components to display hero details and show an array of heroes.
|
|
|
|
* Use one-way data binding for read-only data.
|
|
|
|
* Add editable fields to update a model with two-way data binding.
|
|
|
|
* Bind component methods to user events, like keystrokes and clicks.
|
|
|
|
* Enable users to select a hero from a master list and edit that hero in the details view.
|
|
|
|
* Format data with pipes.
|
|
|
|
* Create a shared service to assemble the heroes.
|
|
|
|
* Use routing to navigate among different views and their components.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-11-06 13:02:18 -05:00
|
|
|
You'll learn enough Angular to get started and gain confidence that
|
|
|
|
Angular can do whatever you need it to do.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-11-06 13:02:18 -05:00
|
|
|
After completing all tutorial steps, the final app will look like this <live-example name="toh-pt6"></live-example>.
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-06-09 17:48:53 -04:00
|
|
|
## What you'll build
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
Here's a visual idea of where this tutorial leads, beginning with the "Dashboard"
|
|
|
|
view and the most heroic heroes:
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-05-09 18:53:32 -04:00
|
|
|
<figure>
|
|
|
|
<img src='generated/images/guide/toh/heroes-dashboard-1.png' alt="Output of heroes dashboard">
|
2017-02-22 13:09:39 -05:00
|
|
|
</figure>
|
|
|
|
|
2017-04-26 08:11:02 -04:00
|
|
|
You can click the two links above the dashboard ("Dashboard" and "Heroes")
|
2017-03-27 11:08:53 -04:00
|
|
|
to navigate between this Dashboard view and a Heroes view.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
If you click the dashboard hero "Magneta," the router opens a "Hero Details" view
|
|
|
|
where you can change the hero's name.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-05-09 18:53:32 -04:00
|
|
|
<figure>
|
|
|
|
<img src='generated/images/guide/toh/hero-details-1.png' alt="Details of hero in app">
|
2017-02-22 13:09:39 -05:00
|
|
|
</figure>
|
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
Clicking the "Back" button returns you to the Dashboard.
|
|
|
|
Links at the top take you to either of the main views.
|
|
|
|
If you click "Heroes," the app displays the "Heroes" master list view.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-03-30 15:04:18 -04:00
|
|
|
|
2017-05-09 18:53:32 -04:00
|
|
|
<figure>
|
|
|
|
<img src='generated/images/guide/toh/heroes-list-2.png' alt="Output of heroes list app">
|
2017-02-22 13:09:39 -05:00
|
|
|
</figure>
|
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
When you click a different hero name, the read-only mini detail beneath the list reflects the new choice.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
You can click the "View Details" button to drill into the
|
|
|
|
editable details of the selected hero.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
The following diagram captures all of the navigation options.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-05-09 18:53:32 -04:00
|
|
|
<figure>
|
|
|
|
<img src='generated/images/guide/toh/nav-diagram.png' alt="View navigations">
|
2017-02-22 13:09:39 -05:00
|
|
|
</figure>
|
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
Here's the app in action:
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-05-09 18:53:32 -04:00
|
|
|
<figure>
|
|
|
|
<img src='generated/images/guide/toh/toh-anim.gif' alt="Tour of Heroes in Action">
|
2017-02-22 13:09:39 -05:00
|
|
|
</figure>
|