このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
Event: eventPhase プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
eventPhase は Event インターフェイスの読み取り専用プロパティは、イベントフローのどの段階が現在評価されているかを示します。
値
整数値で、イベントフローの現在の評価段階を指定する値を返します。使用可能な値は以下のとおりです。
Event.NONE (0)-
現在、このイベントは処理されていません。
Event.CAPTURING_PHASE (1)-
イベントはターゲットの祖先オブジェクトを通じて伝播されます。 この処理は
Windowから始まり、Document、HTMLHtmlElementと、ターゲットの親に到達するまで要素を介して行われます。 キャプチャモード向けにEventTarget.addEventListener()が呼ばれた時に登録されたイベントリスナーは、この段階で起動されます。 Event.AT_TARGET (2)-
このイベントがイベントのターゲットに到達しています。 この段階向けに登録されたイベントリスナーは、この時点で呼び出されます。もし
Event.bubblesがfalseならば、この段階の終了後にイベントの処理を終了します。 Event.BUBBLING_PHASE (3)-
イベントはターゲットの祖先を逆順に伝播していきます。親から始まり、最終的に
Windowを含む先祖に到達します。 これはバブリングと呼ばれ、Event.bubblesがtrueのときのみ発生します。この段階向けに登録されたイベントリスナーは、この処理中に起動されます。
例
HTML
<h4>Event Propagation Chain</h4>
<ul>
<li>Click 'd1'</li>
<li>Analyze event propagation chain</li>
<li>Click next div and repeat the experience</li>
<li>Change Capturing mode</li>
<li>Repeat the experience</li>
</ul>
<input type="checkbox" id="chCapture" />
<label for="chCapture">Use Capturing</label>
<div id="d1">
d1
<div id="d2">
d2
<div id="d3">
d3
<div id="d4">d4</div>
</div>
</div>
</div>
<div id="divInfo"></div>
CSS
div {
margin: 20px;
padding: 4px;
border: thin black solid;
}
#divInfo {
margin: 18px;
padding: 8px;
background-color: white;
font-size: 80%;
}
JavaScript
let clear = false;
let divInfo = null;
let divs = null;
let chCapture = null;
window.onload = () => {
divInfo = document.getElementById("divInfo");
divs = document.getElementsByTagName("div");
chCapture = document.getElementById("chCapture");
chCapture.onclick = () => {
removeListeners();
addListeners();
clearDivs();
};
clearDivs();
addListeners();
};
function removeListeners() {
for (const div of divs) {
if (div.id !== "divInfo") {
div.removeEventListener("click", onDivClick, true);
div.removeEventListener("click", onDivClick, false);
}
}
}
function addListeners() {
for (const div of divs) {
if (div.id !== "divInfo") {
if (chCapture.checked) {
div.addEventListener("click", onDivClick, true);
} else {
div.addEventListener("click", onDivClick, false);
div.onmousemove = () => {
clear = true;
};
}
}
}
}
function onDivClick(e) {
if (clear) {
clearDivs();
clear = false;
}
if (e.eventPhase === 2) {
e.currentTarget.style.backgroundColor = "red";
}
const level =
["none", "capturing", "target", "bubbling"][e.eventPhase] ?? "error";
const para = document.createElement("p");
para.textContent = `${e.currentTarget.id}; eventPhase: ${level}`;
divInfo.appendChild(para);
}
function clearDivs() {
for (let i = 0; i < divs.length; i++) {
if (divs[i].id !== "divInfo") {
divs[i].style.backgroundColor = i % 2 !== 0 ? "#f6eedb" : "#cceeff";
}
}
divInfo.textContent = "";
}
結果
仕様書
| 仕様書 |
|---|
| DOM # ref-for-dom-event-eventphase3 |
ブラウザーの互換性
ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。