Component Interaction With Inputs in Angular


While this tutorial has content that we believe is of great benefit to our community, we have not yet tested or edited it to ensure you have an error-free learning experience. It's on our list, and we're working on it! You can help us out by using the "report an issue" button at the bottom of the tutorial.

Inputs provide a mechanism to allow a parent component to bind properties that a child component can have access to. The parent component pushes the properties to the child component.

This post covers Angular 2 and up

In the parent component’s template, simply define property bindings in the child’s selector. The binding should point to properties available in the parent component’s class on the right side of the equal sign that you want to make available to a the child component. As for the name of the binding itself (left side of the equal sign), it’s totally up to you:

Parent component template: story.component.html
<selected-story [story]="currentStory" [character]="mainCharacter">
Parent component class: story.component.ts
export class StoryComponent {
  currentStory: string = 'The Fox Without a Tail';
  mainCharacter: string = 'Henry';

Now, in the child component, import Input from @angular/code and define your inputs with the @Input decorator like this:

Child component class: selected-story.component.ts
import { Component, Input } from '@angular/core';


Our child component now has access to the value of currentStory and mainCharacter from the parent component. Note how we aliased character to call the property myCharacter in the child component instead:

Child component template: selected-story.component.html
The story: {{ story }}
The character: {{ myCharacter }}

See Also:

Creative Commons License