Abschnitt 12 · Lektion 5
Bubbling
Ein Menü soll sich schließen, sobald irgendwo in seinen Bereich geklickt wird, und darin steht ein Button mit eigenem Listener. Klickst du auf den Button, laufen beide. Ein Klick auf einen Button ist nämlich auch ein Klick auf das Element darum, und auf das darum, bis hinauf zum document und zum Fenster.
Das Ereignis steigt auf
<div id="aussen">
außen
<div id="mitte">
mitte
<button id="innen" type="button">innen</button>
</div>
</div>
<pre id="protokoll"></pre> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
button,
input,
select,
textarea {
font: inherit;
}
button {
padding: 0.4rem 0.8rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
background: #fafaf9;
cursor: pointer;
}
#aussen {
padding: 16px;
background: #e2e8f0;
}
#mitte {
padding: 16px;
background: #cbd5e1;
} const protokoll = document.getElementById("protokoll");
function notiere(text) {
protokoll.textContent = `${protokoll.textContent}${text}\n`;
}
// Drei Listener auf drei Ebenen, alle auf "click".
document.getElementById("innen").addEventListener("click", (event) => {
notiere(`innen (target war ${event.target.tagName})`);
});
document.getElementById("mitte").addEventListener("click", (event) => {
notiere(`mitte (target war ${event.target.tagName})`);
});
document.getElementById("aussen").addEventListener("click", (event) => {
notiere(`außen (target war ${event.target.tagName})`);
});
console.log("Ein Klick auf den Button schreibt drei Zeilen, ein Klick daneben weniger."); Ein Klick auf den Button im ersten Beispiel läuft nacheinander durch alle drei Listener, erst innen, dann mitte, dann außen. Von innen nach außen also, und deshalb heißt das Bubbling. Es steigt auf wie eine Blase.
Dabei ist es wirklich dasselbe Ereignis. event.target bleibt auf allen drei Ebenen der Button, denn dort ist es passiert. Was sich ändert, ist event.currentTarget, das ist jeweils das Element, dessen Listener gerade läuft. Das ist der Unterschied aus der Lektion über das Event-Objekt, und hier siehst du, wozu er gut ist.
Klickst du daneben statt auf den Button, laufen entsprechend weniger Listener. Der Weg beginnt immer dort, wo der Klick war.
Drei Phasen
<div id="aussen">
<button id="innen" type="button">Speichern</button>
</div>
<pre id="protokoll"></pre> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
button,
input,
select,
textarea {
font: inherit;
}
button {
padding: 0.4rem 0.8rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
background: #fafaf9;
cursor: pointer;
}
#aussen {
padding: 16px;
background: #e2e8f0;
} const protokoll = document.getElementById("protokoll");
function notiere(text) {
protokoll.textContent = `${protokoll.textContent}${text}\n`;
}
const aussen = document.getElementById("aussen");
// Mit true als drittem Argument: Capturing. Läuft auf dem
// Weg nach UNTEN, also vor dem Ziel.
aussen.addEventListener("click", () => notiere("1. außen, Capturing"), true);
// Am Ziel selbst.
document.getElementById("innen").addEventListener("click", () => notiere("2. innen, Ziel"));
// Ohne drittes Argument: Bubbling. Läuft auf dem Weg nach OBEN.
aussen.addEventListener("click", () => notiere("3. außen, Bubbling"));
console.log("Ein einziger Klick, drei Zeilen, feste Reihenfolge."); Genau genommen läuft ein Ereignis zweimal durch den Baum.
- Capturing, von ganz oben nach unten bis zum Ziel.
- Ziel, am Element selbst.
- Bubbling, vom Ziel wieder nach oben.
addEventListener hängt den Listener standardmäßig an die Bubbling-Phase. Mit einem true als drittem Argument hängt er stattdessen an der Capturing-Phase, und dann läuft er vor dem Ziel.
Im Alltag brauchst du das fast nie. Hat man es einmal gesehen, versteht man aber, warum ein Listener manchmal früher feuert als erwartet.
stopPropagation
<div id="aussen">
<button id="frei" type="button">normal</button>
<button id="gestoppt" type="button">mit stopPropagation</button>
</div>
<pre id="protokoll"></pre> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
button,
input,
select,
textarea {
font: inherit;
}
button {
padding: 0.4rem 0.8rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
background: #fafaf9;
cursor: pointer;
}
#aussen {
padding: 16px;
background: #e2e8f0;
} const protokoll = document.getElementById("protokoll");
function notiere(text) {
protokoll.textContent = `${protokoll.textContent}${text}\n`;
}
document.getElementById("frei").addEventListener("click", () => {
notiere("frei: geklickt");
});
document.getElementById("gestoppt").addEventListener("click", (event) => {
notiere("gestoppt: geklickt");
event.stopPropagation();
});
// Angenommen, das hier hat jemand anders geschrieben, ein
// Menü, das sich schließen soll, sobald man irgendwo
// in den Bereich klickt. Beim zweiten Button erfährt es
// davon nichts mehr.
document.getElementById("aussen").addEventListener("click", () => {
notiere("außen: Menü würde jetzt schließen");
});
console.log("Die beiden Buttons schreiben verschieden viele Zeilen ins Protokoll."); event.stopPropagation() beendet die Reise. Alle Listener weiter oben bekommen das Ereignis nicht mehr.
Das ist manchmal richtig und hat einen Preis, den man selten sofort sieht. Wer die Reise beendet, schneidet Handler ab, von denen er nichts weiß.
Im dritten Beispiel hängt außen ein Listener, der ein Menü schließen soll. Beim zweiten Button erfährt er davon nichts mehr, und das Menü bliebe offen. Solche Fehler sind unangenehm zu finden, weil Ursache und Wirkung an ganz verschiedenen Stellen im Code stehen.
Ich nehme stopPropagation nur, wenn ich weiß, wem ich damit etwas wegnehme. Oft ist eine genauere Prüfung im äußeren Handler die bessere Lösung.
Außerdem gibt es noch stopImmediatePropagation(). Das schneidet zusätzlich die übrigen Listener am selben Element ab, und dafür gibt es noch weniger gute Gründe.
Was nicht aufsteigt
Nicht jedes Ereignis steigt auf. Vier davon kamen in Lektion 12.3 schon vor, focus, blur, mouseenter und mouseleave. Für die ersten beiden gibt es Ersatz, der aufsteigt, nämlich focusin und focusout, für die anderen beiden mouseover und mouseout.
Für die nächste Lektion ist das eine echte Grenze. Ein Listener am Elternteil hört in der Bubbling-Phase nichts davon, und auf genau dieser Phase baut die Delegation auf. In der Capturing-Phase käme focus zwar an. Einfacher ist focusin.
In der Aufgabe protokollieren Listener auf drei Ebenen einen Klick, und einer der beiden Buttons hält die Weitergabe an.
Zum Mitnehmen
Ein Ereignis passiert unten und läuft nach oben durch alle Listener der umgebenden Elemente, und darauf baut die Event-Delegation auf. stopPropagation beendet diese Reise auch für Handler, die jemand anders geschrieben hat.
Jetzt du
Basis Konto, kostenlosZu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.
Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.
Was in dieser Lektion steckt
-
Artikel mit 3 Beispielen zum Ausprobieren
Steht hier, ohne Konto lesbar.
-
Aufgabe im Editor, direkt im Browser geprüft
Öffnet sich mit dem Basis Konto.