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導入Renderer
        private 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