class security final

A wrapper around a native element inside of a View.

See more...

Security risk

Permitting direct access to the DOM can make your application more vulnerable to XSS attacks. Carefully review any use of ElementRef in your code. For more detail, see the Security Guide.

class ElementRef<T = any> {
  constructor(nativeElement: T)
  nativeElement: T


An ElementRef is backed by a render-specific element. In the browser, this is usually a DOM element.


constructor(nativeElement: T)

nativeElement T


Property Description
nativeElement: T

The underlying native element or null if direct access to native elements is not supported (e.g. when the application runs in a web worker).

Use with caution

Use this API as the last resort when direct access to DOM is needed. Use templating and data-binding provided by Angular instead. Alternatively you can take a look at Renderer2 which provides API that can safely be used even when direct access to native elements is not supported.

Relying on direct DOM access creates tight coupling between your application and rendering layers which will make it impossible to separate the two and deploy your application into a web worker.

© 2010–2022 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.