eventPhase プロパティ
event.eventPhase
eventPhase プロパティは、イベントがキャプチャやバブリングといったどの段階(フェーズ)にあるのかを返すEventのプロパティです。
document.getElementById("example").addEventListener("click", (event) => {
console.log( event.eventPhase );
}, false);
詳しくは Example を参照してください
フェーズは、イベントの発生元、キャプチャとバブリング、イベントが起きていないに分けられます。
ページ内 Index
- ad -
フェーズについて
eventPhase プロパティの返り値とイベントがどの段階(フェーズ)であるかは以下のようになっています。
| 番号 | 摘要 |
|---|---|
| 0 | イベントが発生していない |
| 1 | キャプチャ |
| 2 | ターゲット(イベントの発生元) |
| 3 | バブリング |
以下は、バブリングとキャプチャ、イベントの発生元とフェーズの番号を示した図です。
| defaultView | |||
| ┃ | ↑ | ||
| ( キャプチャー : フェーズ 1 ) | ┃ | ┃ | (バブリング : フェーズ 3 ) |
| ↓ | ┃ | ||
| Document | |||
| ︰ | ↑ | ||
| ( キャプチャー : フェーズ 1 ) | ┃ | ┃ | (バブリング : フェーズ 3 ) |
| ┃ | ┃ | ||
| ↓ | ︰ | ||
| 親のエレメント | |||
| ┃ | ↑ | ||
| ( キャプチャー : フェーズ 1 ) | ┃ | ┃ | (バブリング : フェーズ 3 ) |
| ↓ | ┃ | ||
| エレメント ( *イベントが発生 : フェーズ 2 ) | |||
構文(Syntax)
返り値はNumber型です。
Number = event.eventPhase;
返り値(Return Values)
| Type | Value | 摘要 |
|---|---|---|
| Number | NONE | 0...なし |
| CAPTURING_PHASE | 1...キャプチャの段階 | |
| AT_TARGET | 2...ターゲット(イベントが主ターゲットにしているエレメント) | |
| BUBBLING_PHASE | 3...バブリング(子要素でイベントが発生) |
Example
eventPhase の例です。確認ボタン
をクリックして例を実行してください。
- ad -
