Important Update

The Guide Feature will be discontinued after December 15th, 2023. Until then, you can continue to access and refer to the existing guides.

Gaurav Singhal

Understanding the Purpose of Nested Components

Gaurav Singhal

Dec 2, 2019
13 Min read
44,909 Views

Dec 2, 2019
13 Min read
44,909 Views

Languages Frameworks and Tools

Angular

Introduction

An Angular application can contain thousands of components, and managing data communication may be complex. To overcome this, we need to have parent-child component communication to pass the data so our application is easily manageable in the future.

In Angular, we can have a child component of a parent component where the child component has its own business logic and design that can act as a small unit of functionality for the whole component.

For example, we have chat applications where one page may consist of several child components, such as a header component, body component, chat text-box component, and button component. Altogether, we have a complete chat parent component.

What is a Nested Component?

Angular allows us to have a different child, or nested component, which is the same component we normally use in an Angular application. The difference between them is that this child component contains the logic which can be used into the parent component as a single unit.

Every child component associated with a parent component is called a nested component.

Moreover, one use of nested components is to send data from the child component to the parent so that an action can be triggered by the parent based on the instruction provided by the child component.

Why We Need Nested Components

As we know, every application may contain tons of files, and when an application starts growing, it can be impossible to maintain those trees of files and the application's functionality.

In Angular, we have nested Components, which allow us to put reusable logic into the separate units, which can be associated with one or more different components at a time.

How to Create Nested Components

As we have discussed, a nested component is a normal component, but we use it with a parent component to communicate data between them.

Let’s look at a simple example where we will create two different nested components using Angular CLI and use them with a parent component.

To generate the nestedcomponent1 :

1ng generate component nestedcomponent1

shell

To generate the nestedcomponent2 :

1ng generate component nestedcomponent2

shell

Here, we have created two different components using CLI, but before proceeding with the nested component, we need to declare it within app.module.ts, our root module file for the application, which looks like this.

1import { NgModule } from '@angular/core';
2import { BrowserModule } from '@angular/platform-browser';
3import { FormsModule } from '@angular/forms';
4import { AppComponent } from './app.component';
5
6// Creatd nested component
7
8import { Nestedcomponent1Component } from'./nestedcomponent1/nestedcomponent1.component';
9
10import { Nestedcomponent2Component } from'./nestedcomponent2/nestedcomponent2.component';
11
12@NgModule({
13  imports: [BrowserModule, FormsModule],
14  declarations: [AppComponent, Nestedcomponent1Component, Nestedcomponent2Component],
15  bootstrap: [AppComponent]
16})
17
18export class AppModule { }

typescript

Here in this file, we have imported our two nested components, and after importing them, we need to specify that component into the array called declaration. This means we have declared that component can be used by the application.

Now let’s open a file called app.component.html and put a source code.

1<app-nestedcomponent1></app-nestedcomponent1>
2
3<app-nestedcomponent2></app-nestedcomponent2>

html

Here we have specified the nested component’s selector tag, which we have created previously, and by using such a selector, we will be able to render the view part of that child component into the parent component.

Let’s change the same file and add a static message so that we can see the difference.

1<p>
2    This is parent component
3</p>
4
5<app-nestedcomponent1></app-nestedcomponent1>
6<app-nestedcomponent2></app-nestedcomponent2>

html

Now, when we run this example, we can see the output:

Screenshot

As we can see in the above screenshot, the first line is the static line we have added already, and the other two lines are the view part of the nested component.

So whenever our parent component is rendered, at that time, the nested component’s view will also be rendered.

This is just a simple example that shows how to put a nested component’s selector into a parent and render the content. Now let’s try another example to pass the data from the parent component to the child component.

Passing Data from Parent to Nested Component

We'll use a nested component to pass data to and from a child component and perform an action based on various instructions.

In order to pass data from the parent and get the value into the nested component, we use the @Input decorator, a kind of attribute directive used to bind the expression into the directive.

The @Input decorator is used to get the input values from the component, and the process is based on the provided instruction.

Let’s look at a simple example where we will use an array value, pass it to the nested component, and at the end, get it using the @Input decorator.

For that, let’s create a new component called employeelist using the below npm command.

1Ng generate component employeelist

shell

After creating the component, open that file and paste the following lines of source code.

Employeelist.component.html

1<p>
2    employeelist works!
3</p> 
4<div>
5    <ul>
6        <li *ngFor="let item of employeelist">{{ item }}</li>
7    </ul>
8</div>

html

Here in this file, we have simple div along with the unordered list items, which we will get from the parent component via @Input decorator, so we need to declare it into the child component like this:

Employeelist.component.ts

1import { Component, OnInit, Input } from '@angular/core';
2
3@Component({
4  selector: 'app-employeelist',
5  templateUrl: './employeelist.component.html',
6  styleUrls: ['./employeelist.component.css']
7})
8
9export class EmployeelistComponent implements OnInit {
10
11  // Input decorator
12  @Input() employeelist : string[];
13
14  constructor() { }
15
16  ngOnInit() {
17  }
18
19}

typescript

As we can see, we have the complete component file where we have imported the @Input decorator.

1import { Component, OnInit, Input } from '@angular/core';

typescript

Then we can use it into the component.

1// Input decorator
2
3  @Input() employeelist : string[];

typescript

employeelist is a variable that we will use into the template file in order to get the data and render it down.

We are now done with the employeelist nested component, and now it’s time to pass the actual data from the parent component.

For that, open app.component.ts and the source code will look like this:

1import { Component } from '@angular/core';
2
3@Component({
4  selector: 'my-app',
5  templateUrl: './app.component.html',
6  styleUrls: [ './app.component.css' ]
7})
8
9export class AppComponent  {
10
11  employeelist = [
12    'Test Employee 1',
13    'Test Employee 2',
14    'Test Employee 3',
15    'Test Employee 4',
16    'Test Employee 5'
17  ];
18
19  ngOnInit() {
20    console.log(this.employeelist)
21  }
22
23}

typescript

In this parent component, we have declared and assigned the values to it, which is the simple variable that we are going to send to the child component.

Now open the app.component.html file and paste the following lines of source code.:

1<app-employeelist 
2    [employeelist]="employeelist">
3</app-employeelist>

html

In this file, we have used the nested component’s selector, app-employeelist, so that the content of the nested component will be rendered, but along with the selector, we have also used additional attributes:

1[employeelist]="employeelist"

html

In this case, the name of the attribute and its value are the same, but it’s not necessary to do this.

You may get confused because I have used [ ] along with the attribute, but this is just a type of attribute binding. Anytime we want to bind the attribute with the dynamic value, attribute binding is useful.

Now we are done with our example, which shows a list of items from the array in parent component and passes them to the child component, where we have used an unordered list to show the list of items.

When we run the above example, we get output like this:

Screenshot

As you can see in the above image, we have rendered the list of items from the array employeelist, which is coming from the parent component.

This is how we can pass the data or input from the parent to the nested component via the @Input decorator, and we have plenty of options.

How to Pass Dynamic Input to the Nested Component

In Angular, we can pass data from a parent to a nested component using different approaches. We have already seen an example using @Input decorator to get input values from a parent to a child component.

In the same way, we can also pass dynamic input values to a child component using the @Input decorator.

Let’s look at a simple example where we will use the input box into the parent, and whenever the user changes the value, it will be reflected and shown by the nested component.

For that, we will create a component called nestedinput by using the below CLI command.

1Ng generate component nestedinput

shell

After creating the above component, let’s modify its file content.

Nestedinput.component.html

In this view file, we just have used the local component’s variable so that we can show the dynamic value coming from the parent component.

1<p>
2    To child component : {{ myinput }}
3</p>

html

Nestedinput.component.ts

1import { Component, OnInit, Input } from '@angular/core';
2
3@Component({
4  selector: 'app-nestedinput',
5  templateUrl: './nestedinput.component.html',
6  styleUrls: ['./nestedinput.component.css']
7})
8
9export class NestedinputComponent implements OnInit {
10
11  // Input decorator
12  @Input() myinput : string;
13
14  constructor() { }
15  ngOnInit() {
16  }
17}

typescript

Here in this example, we have declared one variable called myinput, which is associated with the input decorator, and the same variable will get the dynamic value from the parent component whenever the value is changed by the user.

Now let’s open app.component.html file and paste the following source code:

1From parent : <input type="text" [(ngModel)]="myinput" />
2
3<app-nestedinput [myinput]="myinput"></app-nestedinput>

html

Notice that we have used the two-way data binding mechanism in order to get the input’s value, and the same value will be passed to the child component as an attribute binding like this:

1[myinput]="myinput"

html

After using the attribute binding, the nested component will be able to get the dynamic value from the parent component.

Finally, let’s modify our app.component.ts file, which will look like this.

1import { Component } from '@angular/core';
2
3@Component({
4  selector: 'my-app',
5  templateUrl: './app.component.html',
6  styleUrls: [ './app.component.css' ]
7})
8
9export class AppComponent  {
10
11  // Local variable
12  myinput: string = "PluralSight" 
13
14}

typescript

As I mentioned, the myinput is a component variable that can be used to get the dynamic value whenever the user changes the actual value, and it will be reflected in the child component at the time.

Now when we run the above example, the output will look like this.:

Screenshot

From the parent component, we will change the text box value; at that time, we are showing the same text but from the nested component.

This is how we pass values or data from the parent component to the child component using the decorator.

Pass Data from Parent to Nested and Nested to Parent Component

So far, we have learned how to create a nested component and pass static or dynamic data from a parent component to the nested component.But sometimes we may need to pass data in reverse order, i.e. from child to parent.This is also possible in Angular.

Below are several ways of passing data between parent and nested components.

Using @Input() decorator

Using @Output decorator

Using template reference variables

Using @ViewChild approach

Using services (if not parent-nested relationship)

These are the most common ways to pass data between components that may or may not be interrelated.

Conclusion

In this guide, we have learned about nested components, why we need them, and most importantly, how to pass data from a parent to a nested component. We have also seen a few ways to pass data between components, whether they are connected or not.

I hope this guide helped you understand how to use nested components in your Angular application. To learn more, check out my other guides.

LEARN MORE