Glossary

You can compile Angular applications at build-time. By compiling your application using the compiler-cli, ngc, you can bootstrap directly to a module factory, meaning you don't need to include the Angular compiler in your JavaScript bundle. Ahead-of-time compiled applications also benefit from decreased load time and increased performance.

When unqualified, annotation refers to a Dart metadata annotation (as opposed to, say, a type annotation). A metadata annotation begins with the character @, followed by either a reference to a compile-time constant (such as Component) or a call to a constant constructor. See the Dart Language Guide for details.

The corresponding term in TypeScript and JavaScript is decorator.

A category of directive that can listen to and modify the behavior of other HTML elements, attributes, properties, and components. They are usually represented as HTML attributes, hence the name.

A good example of an attribute directive is the ngClass directive for adding and removing CSS class names.

Almost always refers to Data Binding and the act of binding an HTML object property to a data object property.

May refer to a dependency injection binding between a "token", also referred to as a "key", and a dependency provider. This more rare usage should be clear in context.

You launch an Angular application by "bootstrapping" it with the bootstrap method. Bootstraping identifies an application's top level "root" component, which is the first component that is loaded for the application, and optionally registers service providers with the dependency injection system. For more information, see the Setup page.

You can bootstrap multiple apps in the same index.html, each with its own top level root.

The practice of writing compound words or phrases such that each word or abbreviation begins with a capital letter except the first letter, which is lowercase.

Function, property, and method names are typically spelled in camelCase. Examples include: square, firstName and getHeroes. Notice that square is an example of how you write a single word in camelCase.

This form is also known as lower camel case, to distinguish it from upper camel case, which is PascalCase. When you see "camelCase" in this documentation it always means lower camel case.

An Angular class responsible for exposing data to a view and handling most of the view’s display and user-interaction logic.

The component is one of the most important building blocks in the Angular system. It is, in fact, an Angular directive with a companion template.

You apply the @Component annotation to the component class, thereby attaching to the class the essential component metadata that Angular needs to create a component instance and render it with its template as a view.

Those familiar with "MVC" and "MVVM" patterns will recognize the component in the role of "controller" or "view model".

The practice of writing compound words or phrases such that each word is separated by a dash or hyphen (-). This form is also known as kebab-case.

Directive selectors (like my-app) and the root of filenames (such as hero-list.component.ts) are often spelled in dash-case.

Applications display data values to a user and respond to user actions (clicks, touches, keystrokes).

Instead of manually pushing application data values into HTML, attaching event listeners, pulling changed values from the screen, and updating application data values, you can use data binding by declaring the relationship between an HTML widget and data source and let the framework handle the details.

Angular has a rich data binding framework with a variety of data binding operations and supporting declaration syntax.

Read about the forms of binding in the Template Syntax page:

• Interpolation.
• Property binding.
• Event binding.
• Attribute binding.
• Class binding.
• Style binding.
• Two-way data binding with ngModel.

When used in this guide, these JavaScript terms are taken as synonymous with annotation.

Dependency injection is both a design pattern and a mechanism for creating and delivering parts of an application to other parts of an application that request them.

Angular developers prefer to build applications by defining many simple parts that each do one thing well and then wiring them together at runtime.

These parts often rely on other parts. An Angular component part might rely on a service part to get data or perform a calculation. When part "A" relies on another part "B", you say that "A" depends on "B" and that "B" is a dependency of "A".

You can ask a "dependency injection system" to create "A" for us and handle all the dependencies. If "A" needs "B" and "B" needs "C", the system resolves that chain of dependencies and returns a fully prepared instance of "A".

Angular provides and relies upon its own sophisticated dependency injection system to assemble and run applications by "injecting" application parts into other application parts where and when needed.

At the core there is an injector that returns dependency values on request. The expression injector.get(token) returns the value associated with the given token.

A token is an Angular type (OpaqueToken). You rarely deal with tokens directly; most methods accept a class name (Foo) or a string ("foo") and Angular converts it to a token. When you write injector.get(Foo), the injector returns the value associated with the token for the Foo class, typically an instance of Foo itself.

During many of its operations, Angular makes similar requests internally, such as when it creates a component for display.

The Injector maintains an internal map of tokens to dependency values. If the Injector can't find a value for a given token, it creates a new value using a Provider for that token.

A provider is a recipe for creating new instances of a dependency value associated with a particular token.

An injector can only create a value for a given token if it has a provider for that token in its internal provider registry. Registering providers is a critical preparatory step.

Angular registers some of its own providers with every injector. We can register our own providers.

Read more in the Dependency Injection page.

An Angular class responsible for creating, reshaping, and interacting with HTML elements in the browser DOM. Directives are Angular's most fundamental feature.

A Directive is almost always associated with an HTML element or attribute. We often refer to such an element or attribute as the directive itself. When Angular finds a directive in an HTML template, it creates the matching directive class instance and gives the instance control over that portion of the browser DOM.

You can invent custom HTML markup (for example, <my-directive>) to associate with your custom directives. You add this custom markup to HTML templates as if you were writing native HTML. In this way, directives become extensions of HTML itself.

Directives fall into one of three categories:

1. Components that combine application logic with an HTML template to render application [views]. Components are usually represented as HTML elements. They are the building blocks of an Angular application and the developer can expect to write a lot of them.

2. Attribute directives that can listen to and modify the behavior of other HTML elements, attributes, properties, and components. They are usually represented as HTML attributes, hence the name.

3. Structural directives, a directive responsible for shaping or reshaping HTML layout, typically by adding, removing, or manipulating elements and their children.

The official JavaScript language specification.

The latest approved version of JavaScript is ECMAScript 2016 (AKA "ES2016" or "ES7") and many Angular developers write their applications either in this version of the language or a dialect that strives to be compatible with it, such as TypeScript.

Most modern browsers today only support the much older "ECMAScript 5" (AKA ES5) standard. Applications written in ES2016, ES2015 or one of their dialects must be "transpiled" to ES5 JavaScript.

Angular developers may choose to write in ES5 directly.

Short hand for ECMAScript 2015.

Short hand for ECMAScript 2015.

Short hand for ECMAScript 5, the version of JavaScript run by most modern browsers. See ECMAScript.

An object in the Angular dependency injection system that can find a named "dependency" in its cache or create such a thing with a registered provider.

A directive property that can be the target of a property binding (explained in detail in the Template Syntax page). Data values flow into this property from the data source identified in the template expression to the right of the equal sign.

See the Input and output properties section of the Template Syntax page.

A form of property data binding in which a template expression between double-curly braces renders as text. That text may be concatenated with neighboring text before it is assigned to an element property or displayed between element tags, as in this example.

My current hero is {{hero.name}}

Read more about interpolation in the Template Syntax page.

With Angular just-in-time bootstrapping you compile your components and modules in the browser and launch the application dynamically. This is a good choice during development. Consider using the ahead-of-time mode for production apps.

See dash-case.

Directives and components have a lifecycle managed by Angular as it creates, updates, and destroys them.

You can tap into key moments in that lifecycle by implementing one or more of the lifecycle hook interfaces.

Each interface has a single hook method whose name is the interface name prefixed with ng. For example, the OnInit interface has a hook method named ngOnInit.

Angular calls these hook methods in the following order:

• ngOnChanges - when an input/output binding value changes.
• ngOnInit - after the first ngOnChanges.
• ngDoCheck - developer's custom change detection.
• ngAfterContentInit - after component content initialized.
• ngAfterContentChecked - after every check of component content.
• ngAfterViewInit - after component's view(s) are initialized.
• ngAfterViewChecked - after every check of a component's view(s).
• ngOnDestroy - just before the directive is destroyed.

Read more in the Lifecycle Hooks page.

In this guide, the term module refers to a Dart compilation unit, such as a library, or a package. (If a Dart file has no library or part directive, then that file itself is a library and thus a compilation unit.) For more information about compilation units, see the chapter on "Libraries and Scripts" in the Dart Language Specification.

A directive property that can be the target of event binding. Events stream out of this property to the receiver identified in the template expression to the right of the equal sign.

See the Input and output properties section of the Template Syntax page.

The practice of writing individual words, compound words, or phrases such that each word or abbreviation begins with a capital letter. Class names are typically spelled in PascalCase. Examples include: Person and HeroDetailComponent.

This form is also known as upper camel case to distinguish it from lower camel case, which is simply called camelCase. In this documentation, "PascalCase" means upper camel case and "camelCase" means lower camel case.

An Angular pipe is a function that transforms input values to output values for display in a view. Use the @Pipe annotation to associate the pipe function with a name. You then use that name in your HTML to declaratively transform values on screen.

Here's an example that uses the built-in currency pipe to display a numeric value in the local currency.

Price: {{product.price | currency}}

Read more in the page on pipes.

A provider creates a new instance of a dependency for the dependency injection system. It relates a lookup token to code—sometimes called a "recipe"—that can create a dependency value.

Most applications consist of many screens or views. The user navigates among them by clicking links and buttons, and performing other similar actions that cause the application to replace one view with another.

The Angular component router is a richly featured mechanism for configuring and managing the entire view navigation process including the creation and destruction of views.

An Angular component with a RouterOutlet that displays views based on router navigations.

For more information, see the Routing & Navigation page.

The practice of writing compound words or phrases such that an underscore (_) separates one word from the next. This form is also known as underscore case.

Library and file names are often spelled in snake_case. Examples include: angular_tour_of_heroes and app_component.dart.

For data or logic that is not associated with a specific view or that you want to share across components, build services.

Applications often require services such as a hero data service or a logging service.

A service is a class with a focused purpose. We often create a service to implement features that are independent from any specific view, provide shared data or logic across components, or encapsulate external interactions.

For more information, see the Services page of the Tour of Heroes tutorial.

A category of directive that can shape or reshape HTML layout, typically by adding, removing, or manipulating elements and their children; for example, the ngIf "conditional element" directive and the ngFor "repeater" directive.

Read more in the Structural Directives page.

A template is a chunk of HTML that Angular uses to render a view with the support and continuing guidance of an Angular directive, most notably a component.

An expression is a Dart-like syntax that Angular evaluates within a data binding.

Read about how to write template expressions in the Template Syntax page.

The process of transforming code written in one form of JavaScript (for example, TypeScript) into another form of JavaScript (for example, ES5).

A version of JavaScript that supports most ECMAScript 2015 language features such as decorators.

TypeScript is also noteable for its optional typing system, which gives us compile-time type checking and strong tooling support (for example, "intellisense", code completion, refactoring, and intelligent search). Many code editors and IDEs support TypeScript either natively or with plugins.

TypeScript is the preferred language for Angular development although you can use other JavaScript dialects such as ES5.

Read more about TypeScript at typescript.org.

A view is a portion of the screen that displays information and responds to user actions such as clicks, mouse moves, and keystrokes.

Angular renders a view under the control of one or more directives, especially component directives and their companion templates. The component plays such a prominent role that it's often convenient to refer to a component as a view.

Views often contain other views and any view might be loaded and unloaded dynamically as the user navigates through the application, typically under the control of a router.

Zones are a mechanism for encapsulating and intercepting a Dart application's asynchronous activity.

Learn more about zones in this article.