Angular 4.x Events Bubbling

Angular 组件和 DOM 元素通过事件与外部进行通信， Angular 事件绑定语法对于组件和 DOM 元素来说是相同的 - (eventName)="expression" ：

<button (click)="onClick()">Click</button>

DOM ELEMENTS

DOM 元素触发的一些事件通过 DOM 层级结构传播。这种传播过程称为事件冒泡。事件首先由最内层的元素开始，然后传播到外部元素，直到它们到根元素。DOM 事件冒泡与 Angular 可以无缝工作，具体示例如下：

import { Component } from '@angular/core';@Component({selector: 'exe-app',template: `<div (click)="onClick()"><button>Click</button></div>`
})
export class AppComponent {onClick() {console.log('Click');}
}

以上代码成功运行后，当用户点击 Click 按钮，浏览器控制台将会输出：

Click

即表示 <div> 元素上设置的监听函数被执行，也间接证明了事件冒泡能正常工作。

Angular Component

Angular 允许开发者通过 @Output() 装饰器和 EventEmitter 自定义事件。它不同于 DOM 事件，因为它不支持事件冒泡。在介绍自定义事件前，我们先来看一下自定义组件如何监听 DOM 事件。

event-bubbling.component.ts

import { Component } from '@angular/core';@Component({selector: 'event-bubbling',template: `<div><button>Click</button></div>`
})
export class EventBubblingComponent { }

app.component.ts

import { Component } from '@angular/core';@Component({selector: 'exe-app',template: `<div><event-bubbling (click)="onClick()"></event-bubbling></div>`
})
export class AppComponent {onClick() {console.log('Click');}
}

以上代码成功运行后，当用户点击 Click 按钮，浏览器控制台也会输出 Click。表示我们的自定义组件，也是可以正常处理组件内元素触发的 click 事件。但当我们在自定义组件中创建自定义事件时，事件名称也是使用 click ，那么会不会有问题呢？我们马上来实践一下。

Custom Events

event-bubbling.component.ts

import { Component, Output, EventEmitter } from '@angular/core';@Component({selector: 'event-bubbling',template: `<div><button (click)="onClick('Button 1')">Button 1</button><button (click)="onClick('Button 2')">Button 2</button></div>`
})
export class EventBubblingComponent {@Output() click = new EventEmitter();onClick(button: string) {this.click.next(button);}
}

app.component.ts

import { Component } from '@angular/core';@Component({selector: 'exe-app',template: `<div><event-bubbling (click)="onClick($event)"></event-bubbling></div>`
})
export class AppComponent {onClick(event: any) {console.log(event);}
}

以上代码成功运行后，当用户点击 Button 1 按钮时，浏览器控制台将会输出：

Button 1
MouseEvent {isTrusted: true, screenX: 69, screenY: 161, clientX: 43, clientY: 22…}

我们看到控制台输出了两个信息，说明在这种情况下，Angular 可以处理自定义事件和 DOM (click) 事件。当 click 事件触发后，onClick() 方法接收的 event 参数是 MouseEvent 对象。

那么要如何修复这个问题呢？我们可以利用 DOM 事件提供的防止冒泡的机制，即 stopPropagation() 方法。具体示例如下：

event-bubbling.component.ts

import { Component, Output, EventEmitter } from '@angular/core';@Component({selector: 'event-bubbling',template: `<div><button (click)="onClick($event, 'Button 1')">Button 1</button><button (click)="onClick($event, 'Button 2')">Button 2</button></div>`
})
export class EventBubblingComponent {@Output() click = new EventEmitter();onClick(event: Event, button: string) {event.stopPropagation();this.click.next(button);}
}

以上代码成功运行后，当用户点击 Button 1 按钮时，只会输出 Button 1 ，即问题我们已经修复了。

现在我们来总结一下：

DOM 事件冒泡机制，允许在父元素监听由子元素触发的 DOM 事件
Angular 支持 DOM 事件冒泡机制，但不支持自定义事件的冒泡。
自定义事件名称与 DOM 事件的名称如 (click，change，select，submit) 同名，可能会导致问题。虽然可以使用 stopPropagation() 方法解决问题，但实际工作中，不建议这样使用。

介绍完上面的内容，接下来我们来介绍一下在 Angular 中如何实现 Event Modifiers。

Event Modifiers

在实际项目中，我们经常需要在事件处理器中调用 preventDefault() 或 stopPropagation() 方法：

preventDefault() - 如果事件可取消，则取消该事件，意味着该事件的所有默认动作都不会发生。需要注意的是该方法不会阻止该事件的冒泡。
stopPropagation() - 阻止当前事件在 DOM 树上冒泡。

对于 preventDefault() 方法，有一个经典的应用场景。即当我们希望点击链接在新窗口打开页面，但不希望当前页面跳转。这个时候可以使用 preventDefault() 阻止后面将要执行的浏览器默认动作。

<a id="link" href="https://segmentfault.com/a/1190000008754631">Angular 4.x 修仙之路</a>
<script>document.getElementById('link').onclick = function(ev) {ev.preventDefault(); // 阻止浏览器默认动作 (页面跳转)window.open(this.href); // 在新窗口打开页面};
</script>

一下子扯远了，赶紧回到正题。在 Angular 中阻止 DOM 事件冒泡，我们可以使用以下两种方式：

方式一

<div><button (click)="$event.stopPropagation(); doSomething()">Click me</button>
</div>

方式二

@Component({selector: 'exe-app',template: `<div><button (click)="doSomething($event)">Click me</button></div>`
})
export class AboutComponent {doSomething($event: Event) {$event.stopPropagation();// your logic}
}

是不是感觉很麻烦，每次都得显式地调用 $event.stopPropagation() 方法。有没有更简便的方法呢？能不能使用声明式的语法？在 Vue 中可以通过声明式的方式，解决我们上面的问题。具体如下：

<!-- the click event's propagation will be stopped -->
<a v-on:click.stop="doThis"></a><!-- the submit event will no longer reload the page -->
<form v-on:submit.prevent="onSubmit"></form><!-- the click event will be triggered at most once -->
<a v-on:click.once="doThis"></a>

接下来我们也来基于 Angular 的指令系统，实现上述的功能。最终的使用示例如下：

<div class="parent" (click)="fromParent()"><button class="child" (click.stop)="fromChild()">Click me</button>
</div>

自定义 [click.stop] 指令

import { Directive, Output, EventEmitter, Renderer2, ElementRef } from '@angular/core';@Directive({selector: '[click.stop]'
})
export class StopPropagationDirective {@Output("click.stop") stopPropEvent = new EventEmitter();unsubscribe: () => void;constructor(private renderer: Renderer2, // Angular 2.x导入Rendererprivate element: ElementRef) {}ngOnInit() {this.unsubscribe = this.renderer.listen(this.element.nativeElement, 'click', event => {event.stopPropagation();this.stopPropEvent.emit(event);});}ngOnDestroy() {this.unsubscribe();}
}

[click.stop] 指令应用

import { Component } from '@angular/core';@Component({selector: 'exe-app',template: `<div class="parent" (click)="fromParent()"><button class="child" (click.stop)="fromChild()">Click me</button></div>`
})
export class AppComponent {fromChild() {console.log('I am Child');}fromParent() {console.log('I am Parent');}
}

以上代码成功运行后，当用户点击 Click me 按钮时，浏览器控制台只会输出 I am Child。若把 (click.stop) 改为 (click) ，当用户再次点击 Click me 按钮时，控制台就会输出两条信息。有兴趣的读者，可以亲自验证一下哈。

参考资源

Implementing Event Modifiers in Angular