Understanding ViewChild, ViewChildren & Querylist in Angular

The ViewChild or ViewChildren decorators are used to Query and get the reference of the DOM element injected inside an Angular component. ViewChild returns the first matching element and ViewChildren returns all the matching elements as a QueryList of items. We can use these references to manipulate element properties in the component.

To Query a DOM element(s), we must supply the query selector, which can be a string or a type as the first argument to the ViewChild or ViewChildren. The argument static determines whether the query is performed, before or after the change detection. The read option allows us to query a different token rather than the default and is useful when the element is associated with multiple types. We will learn all these in this tutorial.


The ViewChild query returns the first matching element from the DOM and updates the component variable on which we apply it.


The Syntax of the viewChild is as shown below.

We apply the viewChild decorator on a Component Property. It takes two arguments. A selector and opts.

selector: can be a string, a type or a function that returns a string or type. The change detector looks for the first element that matches the selector and updates the component property with the reference to the element. If the DOM changes and a new element matches the selector, the change detector updates the component property.

opts: has two options.

static Determines when the query is resolved. True is when the view is initialized (before the first change detection) for the first time. False if you want it to be resolved after every change detection

read: Use it to read the different token from the queried elements.

ViewChild Examples

Now, let us learn ViewChild using few examples.

Injecting Component or Directive

One of the use cases of ViewChild is to get the reference of the Child Component in the Parent Component and manipulate its properties. This is one of the ways by which the Parent can communicate with the child components.

For Example consider the following ChildComponent. It has two methods. Increment & Decrement.

Best Angular Books
The Top 8 Best Angular Books, which helps you to get started with Angular  

We can use the ViewChild in the parent component to get the reference to the ChildComponent

In the code above, the ViewChild looks for the first occurrence of the ChildComponent in the view and updates the child variable. Now we can invoke the methods Increment & Decrement of the ChildComponent from the Parent.

The complete code is as shown below.

Using Template Reference Variable

You can make use of Template Reference Variable instead of the component type.

For Example, you can assign a Template Reference Variable to a component.

and then use it in the ViewChild query to get the reference to the component.

Injecting HTML Element Using ElementRef

The Viewchild can also be used to query HTML elements.

First, assign a Template variable (#para in the example below) to the HTML element. You can then use the ViewChild to query the element.

ViewChild returns a ElementRef, which is nothing but wrapper around the native HTML element.

Multiple Instances

There could be multiple instances of the same component or element in the Template.

The ViewChild always returns the first component.

To get all the instances of the Child Component, we can make use of the ViewChildren, which we cover later in this tutorial.

ViewChild returns Undefined

ViewChild Returning undefined is one of the common errors, we encounter when we use them.

The error is due to the fact that we try to use the value, before the ViewChild initializes it.

For Example, the code below results in Cannot read property 'increment' of undefined. i.e. the component’s view is not yet initialized when the constructor is run. Hence, the Angular yet to update child variable with the reference to the ChildComponet.

The solution is to wait until the Angular Initializes the View. Angular raises the AfterViewInit life cycle hook once it completes the View Initialization. So we can use the ngAfterViewInit to access the child variable.

Now, the code does not give any errors.

The above code will also work with the ngOnInit Life cycle hook. But it is not guaranteed to work all the time as the Angular might not initialize all parts of the view, before raising the ngOnInit hook. Hence it is always better to use the ngAfterViewInit hook.

Also, when ViewChild updates the values also depends on the static option

Using Static Option in ViewChild

We used the {static:true} in the above code.

The static option determines the timing of the ViewChild query resolution.

  • static:true will resolves ViewChild before any change detection is run.
  • static:false will resolves it after every change detection run.

The value of the static becomes important when the child is rendered dynamically. For Example inside a ngIf or ngSwitch etc.

For Example consider the following code, where we have moved the child-component inside the ngIf.

The above code results in a TypeError: Cannot read property 'increment' of undefined. The error occurs even if we assign true to showCounter

Because in the above case Angular does not render the child component immediately. But after the first change detection which detects the value of showCounter and renders the child component.

Since we used static: true, the angular will try to resolve the ViewChild before the first change detection is run. Hence the child variable always will be undefined.

Now, change the static: false. Now the code will work correctly. I.e because after every change detection the Angular updates the ViewChild.

Using the Read Option in ViewChild

A Single element can be associated with multiple types.

For Example, consider the following code. #nameInput template variable is now associated with both input & ngModel

The viewChild code below, returns the instance of the input element as elementRef.

If we want to get the instance of the ngModel, then we use the Read token and ask for the type.

Every element in Angular is always has a ElementRef and ViewContainerRef associated with it. If the element is a component or directive then there is always a component or directive instance. You can also apply more than one directive to an element.

The ViewChild without read token always returns the component instance if it is a component. If not it returns the elementRef.

Injecting a Provider from the Child Component

You can also inject the services provided in the child component.

And in the Parent component, you can access the provider using the read property.

Injecting TemplateRef

You can access the TemplateRef as shown below

Component code


ViewChildren decorator is used to getting the list of element references from the View.

ViewChildren is different from the ViewChild. ViewChild always returns the reference to a single element. If there are multiple elements the ViewChild returns the first matching element,

ViewChildren always returns all the elements as a QueryList. You can iterate through the list and access each element.


The Syntax of the viewChildren is as shown below. It is very much similar to syntax of viewChild except for the static option.

The ViewChildren is always resolved after the change detection is run. i.e why it does not have static option. And also you cannot refer to it in the ngOnInit hook as it is yet to initialize.


The QueryList is the return type of ViewChildren and contentChildren . 

QueryList stores the items returned by the viewChildren or contentChildren in a list.

The Angular updates this list, whenever the state of the application change. It does it on each change detection.

The QueryList also Implements an iterable interface. Which means you can iterate over it using  for (var i of items) or use it with ngFor in template *ngFor="let i of items".

Changes can be observed by subscribing to the changes Observable.

You can use the following methods & properties.

  • first: returns the first item in the list.
  • last: get the last item in the list.
  • length: get the length of the items.
  • changes: Is an observable. It emits a new value, whenever the Angular adds, removes or moves the child elements.

It also supports JavaScript array methods like map()filter() , find()reduce()forEach()some(). etc

ViewChildren Example

In the example below, we have three input elements all using the ngModel directive

We use the ViewChildren to get the QueryList of all input elements

Finally, we can use the this.modelRefList.forEach to loop through the QueryList and access each element.

Listening for QueryList Changes

We can subscribe to the changes observable to find if any new elements are added/removed or moved.

In the example below, we have included ngIf directive to hide/show the input elements.

We subscribe to the changes observable in the component class. Every time we use the ngIf to hide or add the component, the changes observable emits the latest QueryList.


  1. ViewChild API
  2. ViewChildren API
  3. QueryList API
  4. ElementRef API
  5. ViewContainerRef API

Read More

  1. ngModel

Leave a Comment

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Scroll to Top