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:

				
					
[label Parent component template: story.component.html]

<selected-story [story]="currentStory" [character]="mainCharacter">

</selected-story>

				
			
				
					
[label 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:

				
					
[label 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:

				
					
[label Child component template: selected-story.component.html]

The story: {{ story }}

The character: {{ myCharacter }}

				
			

See Also:

component illustration for: See Also: