diff --git a/packages/core/src/metadata/directives.ts b/packages/core/src/metadata/directives.ts index b69dc9624e..660b1d72d7 100644 --- a/packages/core/src/metadata/directives.ts +++ b/packages/core/src/metadata/directives.ts @@ -823,6 +823,11 @@ export interface HostListenerDecorator { /** * Decorator that declares a DOM event to listen for, * and provides a handler method to run when that event occurs. + * + * Angular invokes the supplied handler method when the host element emits the specified event, + * and updates the bound element with the result. + * + * If the handler method returns false, applies `preventDefault` on the bound element. */ (eventName: string, args?: string[]): any; new(eventName: string, args?: string[]): any;