@angular/core

AfterRenderPhase

enum

Developer preview

The phase to run an afterRender or afterNextRender callback in.

enum AfterRenderPhase {
}

The phase to run an afterRender or afterNextRender callback in.

Callbacks in the same phase run in the order they are registered. Phases run in the following order after each render:

AfterRenderPhase.EarlyRead
AfterRenderPhase.Write
AfterRenderPhase.MixedReadWrite
AfterRenderPhase.Read

Angular is unable to verify or enforce that phases are used correctly, and instead relies on each developer to follow the guidelines documented for each value and carefully choose the appropriate one, refactoring their code if necessary. By doing so, Angular is better able to minimize the performance degradation associated with manual DOM access, ensuring the best experience for the end users of your application or library.

EarlyRead

Use AfterRenderPhase.EarlyRead for callbacks that only need to read from the DOM before a subsequent AfterRenderPhase.Write callback, for example to perform custom layout that the browser doesn't natively support. Never use this phase for callbacks that can write to the DOM or when AfterRenderPhase.Read is adequate.

Using this value can degrade performance. Instead, prefer using built-in browser functionality when possible.

Write

Use AfterRenderPhase.Write for callbacks that only write to the DOM. Never use this phase for callbacks that can read from the DOM.

MixedReadWrite

Use AfterRenderPhase.MixedReadWrite for callbacks that read from or write to the DOM, that haven't been refactored to use a different phase. Never use this phase for callbacks that can use a different phase instead.

Using this value can significantly degrade performance. Instead, prefer refactoring into multiple callbacks using a more specific phase.

Read

Use AfterRenderPhase.Read for callbacks that only read from the DOM. Never use this phase for callbacks that can write to the DOM.