Input

decorator

Option Description
bindingPropertyName

Decorator that marks a class field as an input property and supplies configuration metadata. Declares a data-bound input property, which Angular automatically updates during change detection.

Options

Decorator that marks a class field as an input property and supplies configuration metadata. Declares a data-bound input property, which Angular automatically updates during change detection.

bindingPropertyName: string

You can supply an optional name to use in templates when the component is instantiated, that maps to the name of the bound property. By default, the original name of the bound property is used for input binding.

The following example creates a component with two input properties, one of which is given a special binding name.

@Component({
  selector: 'bank-account',
  template: `
    Bank Name: {{bankName}}
     Account Id: {{id}}
  `
})
class BankAccount {
  // This property is bound using its original name.
  @Input() bankName: string;
  // this property value is bound to a different property name
  // when this component is instantiated in a template.
  @Input('account-id') id: string;

  // this property is not bound, and is not automatically updated by Angular
  normalizedBankName: string;
}

@Component({
  selector: 'app',
  template: `
    <bank-account bankName="RBC" account-id="4747"></bank-account>
  `
})

class App {}

© 2010–2019 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v6.angular.io/api/core/Input