This is a practical guide to Angular for experienced programmers who are building client applications in HTML and TypeScript.
Organization
The documentation is divided into major thematic sections, each a collection of pages devoted to that theme.
| QuickStart |
The foundation for every page and sample in this documentation. |
| Tutorial |
A step-by-step, immersive approach to learning Angular that introduces the major features of Angular in an application context. |
| Basics |
The essential ingredients of Angular development. |
| Developer Guide |
In-depth analysis of Angular features and development practices. |
| Cookbook |
Recipes for specific application challenges, mostly code snippets with a minimum of exposition. |
| API Reference |
Authoritative details about each member of the Angular libraries. |
Learning path
You don't have to read the guide straight through. Most pages stand on their own.
For those new to Angular, the recommended learning path runs through the Basics section:
-
For the big picture, read the Architecture overview.
-
Try QuickStart. QuickStart is the "Hello, World" of Angular 2. It shows you how to set up the libraries and tools you'll need to write any Angular app.
-
Take the Tour of Heroes tutorial, which picks up where QuickStart leaves off, and builds a simple data-driven app. The app demonstrates the essential characteristics of a professional application: a sensible project structure, data binding, master/detail, services, dependency injection, navigation, and remote data access.
-
Displaying Data explains how to display information on the screen.
-
User Input covers how Angular responds to user behavior.
-
Forms handles user data entry and validation within the UI.
-
Dependency Injection is the way to build large, maintainable applications from small, single-purpose parts.
-
Template Syntax is a comprehensive study of Angular template HTML.
After reading the above sections, you can skip to any other pages on this site.
Code samples
Each page includes code snippets that you can reuse in your applications. These snippets are excerpts from a sample application that accompanies the page.
Look for a link to a running version of that sample near the top of each page, such as this from the Architecture page.
The link launches a browser-based code editor where you can inspect, modify, save, and download the code.
A few early pages are written as tutorials and are clearly marked as such. The rest of the pages highlight key points in code rather than explain each step necessary to build the sample. You can always get the full source through the live link.
Reference pages
The Cheat Sheet lists Angular syntax for common scenarios.
The Glossary defines terms that Angular developers should know.
The API Reference is the authority on every public-facing member of the Angular libraries.
Feedback
We welcome feedback!
Use the angular.io Github repo for documentation issues and pull requests.
Use the Angular Github repo to report issues with Angular 2 itself.
Please login to continue.