How event binding works

In an event binding, Angular configures an event handler for the target event. You can use event binding with your own custom events.

When the component or directive raises the event, the handler executes the template statement. The template statement performs an action in response to the event.

Handling events

A common way to handle events is to pass the event object, $event, to the method handling the event. The $event object often contains information the method needs, such as a user's name or an image URL.

The target event determines the shape of the $event object. If the target event is a native DOM element event, then $event is a DOM event object, with properties such as target and target.value.

In the following example the code sets the <input> value property by binding to the name property.

<input [value]="currentItem.name"
       (input)="currentItem.name=$event.target.value" >
without NgModel

With this example, the following actions occur:

  1. The code binds to the input event of the <input> element, which allows the code to listen for changes.
  2. When the user makes changes, the component raises the input event.
  3. The binding executes the statement within a context that includes the DOM event object, $event.
  4. Angular retrieves the changed text by following the path $event.target.value and updates the name property.

If the event belongs to a directive or component, $event has the shape that the directive or component produces.

© 2010–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.