ApplicationRef

Stable Class

Class Overview

class ApplicationRef {
  bootstrap(componentFactory: ComponentFactory<C>|Type<C>) : ComponentRef<C>
  tick() : void
  componentTypes : Type<any>[]
  components : ComponentRef<any>[]
  attachView(view: ViewRef) : void
  detachView(view: ViewRef) : void
  viewCount : number
}

Class Description

A reference to an Angular application running on a page.

For more about Angular applications, see the documentation for bootstrap.

Class Details

bootstrap(componentFactory: ComponentFactory<C>|Type<C>) : ComponentRef<C>

Bootstrap a new component at the root level of the application.

Bootstrap process

When bootstrapping a new root component into an application, Angular mounts the specified application component onto DOM elements identified by the [componentType]'s selector and kicks off automatic change detection to finish initializing the component.

@Component({selector: 'my-app', template: 'Hello World'})
class MyApp {
}

const myPlatformFactory = createPlatformFactory(platformBrowserDynamic, 'myPlatform');
myPlatformFactory().bootstrapModule(MyApp);

tick() : void

Invoke this method to explicitly process change detection and its side-effects.

In development mode, tick() also performs a second change detection cycle to ensure that no further changes are detected. If additional changes are picked up during this second cycle, bindings in the app have side-effects that cannot be resolved in a single change detection pass. In this case, Angular throws an error, since an Angular application can only have one change detection pass during which all change detection must complete.

componentTypes : Type<any>[]

Get a list of component types registered to this application. This list is populated even before the component is created.

components : ComponentRef<any>[]

Get a list of components registered to this application.

attachView(view: ViewRef) : void

Attaches a view so that it will be dirty checked. The view will be automatically detached when it is destroyed. This will throw if the view is already attached to a ViewContainer.

detachView(view: ViewRef) : void

Detaches a view from dirty checking again.

viewCount : number

Returns the number of attached views.

exported from @angular/core/index, defined in @angular/core/src/application_ref.ts