| 
									
										
										
										
											2017-11-06 19:02:18 +01:00
										 |  |  | <h1 class="no-toc">Tutorial: Tour of Heroes</h1> | 
					
						
							| 
									
										
										
										
											2017-04-01 01:57:13 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-11-06 19:02:18 +01: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-04-01 01:57:13 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-11-06 19:02:18 +01: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 16:08:53 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-11-06 19:02:18 +01:00
										 |  |  | By the end of the tutorial you will be able to do the following: | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-11-06 19:02:18 +01: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 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-11-06 19:02:18 +01: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 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-11-06 19:02:18 +01:00
										 |  |  | After completing all tutorial steps, the final app will look like this <live-example name="toh-pt6"></live-example>. | 
					
						
							| 
									
										
										
										
											2017-04-01 01:57:13 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-06-09 17:48:53 -04:00
										 |  |  | ## What you'll build
 | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01:00
										 |  |  | Here's a visual idea of where this tutorial leads, beginning with the "Dashboard" | 
					
						
							|  |  |  | view and the most heroic heroes: | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-05-09 23:53:32 +01:00
										 |  |  | <figure> | 
					
						
							|  |  |  |   <img src='generated/images/guide/toh/heroes-dashboard-1.png' alt="Output of heroes dashboard"> | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | </figure> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-04-26 15:11:02 +03:00
										 |  |  | You can click the two links above the dashboard ("Dashboard" and "Heroes") | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01:00
										 |  |  | to navigate between this Dashboard view and a Heroes view. | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01: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 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-05-09 23:53:32 +01:00
										 |  |  | <figure> | 
					
						
							|  |  |  |   <img src='generated/images/guide/toh/hero-details-1.png' alt="Details of hero in app"> | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | </figure> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01: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 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-30 20:04:18 +01:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-05-09 23:53:32 +01:00
										 |  |  | <figure> | 
					
						
							|  |  |  |   <img src='generated/images/guide/toh/heroes-list-2.png' alt="Output of heroes list app"> | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | </figure> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01:00
										 |  |  | When you click a different hero name, the read-only mini detail beneath the list reflects the new choice. | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01:00
										 |  |  | You can click the "View Details" button to drill into the | 
					
						
							|  |  |  | editable details of the selected hero. | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01:00
										 |  |  | The following diagram captures all of the navigation options. | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-05-09 23:53:32 +01:00
										 |  |  | <figure> | 
					
						
							|  |  |  |   <img src='generated/images/guide/toh/nav-diagram.png' alt="View navigations"> | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | </figure> | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-03-27 16:08:53 +01:00
										 |  |  | Here's the app in action: | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-05-09 23:53:32 +01:00
										 |  |  | <figure> | 
					
						
							|  |  |  |   <img src='generated/images/guide/toh/toh-anim.gif' alt="Tour of Heroes in Action"> | 
					
						
							| 
									
										
										
										
											2017-02-22 18:09:39 +00:00
										 |  |  | </figure> |