Abschnitt 12 · Lektion 4
Standardverhalten verhindern
Manche Elemente tun bei einem Ereignis von sich aus etwas, ohne dass jemand dafür Code geschrieben hat. Ein Link führt woandershin, ein Formular wird abgeschickt und die Seite neu geladen, die Leertaste scrollt, ein Rechtsklick öffnet ein Menü. Soll ein Klick auf einen Link stattdessen etwas auf derselben Seite aufdecken, ist das im Weg.
Das ist das Standardverhalten, und event.preventDefault() schaltet es für dieses eine Ereignis ab.
Ein Link, der bleibt
<p><a id="gebremst" href="details.html">Mit preventDefault</a></p>
<p><a id="frei" href="details.html">Ohne preventDefault, Vorsicht</a></p>
<p id="ausgabe">noch nichts</p> <h1>Details</h1>
<p>Das ist die zweite Seite. Du bist hier gelandet, weil der Klick
nicht abgefangen wurde.</p>
<p><a href="index.html">Zurück</a></p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
} const ausgabe = document.getElementById("ausgabe");
// Die Lektionsansicht hängt app.js auch an details.html, und dort
// fehlen die Links. Das ?. lässt den Aufruf dann einfach aus.
document.getElementById("gebremst")?.addEventListener("click", (event) => {
event.preventDefault();
ausgabe.textContent = "Der Link wurde abgefangen";
console.log("abgefangen, die Seite bleibt stehen");
});
// Derselbe Handler ohne die eine Zeile. Der Text wird gesetzt,
// und gleich danach ist die Seite bei details.html.
document.getElementById("frei")?.addEventListener("click", () => {
ausgabe.textContent = "Gleich ist diese Seite weg";
console.log("hier läuft noch alles, aber nicht mehr lange");
});
console.log("Der erste Link bleibt auf der Seite, der zweite führt zu details.html."); Der Handler läuft, ob preventDefault aufgerufen wird oder nicht. Der Unterschied kommt danach. Ohne die Zeile macht der Browser einfach mit dem weiter, was er sowieso vorhatte, und navigiert.
Im Beispiel stehen beide Fälle nebeneinander. Der erste Link setzt den Text und bleibt stehen. Beim zweiten wird der Text auch gesetzt, aber einen Wimpernschlag später steht /details.html in der Adresszeile und darunter die zweite Seite. Die liegt als eigene Datei im Editor, und über „Zurück“ in der Adresszeile oder den Link auf der Seite kommst du wieder her.
In der Console sind die eigenen console.log-Zeilen nach dem Wechsel weg. Eine Navigation lädt ein neues Dokument, und dabei geht alles verloren, was im alten im Speicher stand. Darum geht es auch im nächsten Beispiel.
Umgekehrt behält ein Link, der wirklich woandershin führen soll, sein Standardverhalten. preventDefault gehört nicht vorsorglich in jeden Handler. Es gehört dorthin, wo die eingebaute Reaktion ausdrücklich nicht gewollt ist.
Ein Formular ohne Neuladen
<form id="formular">
<label for="name">Vorname</label> <input id="name" name="name" value="Ida">
<button type="submit">Absenden</button>
</form>
<p id="ausgabe">noch nichts abgeschickt</p> body {
font-family: system-ui, sans-serif;
max-width: 40rem;
margin: 0;
padding: 1rem;
line-height: 1.6;
color: #1c1917;
}
p {
margin: 0 0 0.75rem;
}
button,
input,
select,
textarea {
font: inherit;
}
button {
padding: 0.4rem 0.8rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
background: #fafaf9;
cursor: pointer;
}
input,
select,
textarea {
padding: 0.35rem 0.5rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
} const ausgabe = document.getElementById("ausgabe");
document.getElementById("formular").addEventListener("submit", (event) => {
// Ohne diese Zeile schickt der Browser das Formular ab
// und lädt die Seite neu. Alles darunter liefe zwar noch,
// aber sichtbar bliebe davon nichts.
event.preventDefault();
ausgabe.textContent = "Abgeschickt, ohne Neuladen";
console.log("Der Handler behält die Kontrolle.");
});
// Das ist der häufigste Einsatz von preventDefault überhaupt,
// und Abschnitt 13 baut darauf auf.
console.log("Der Button und die Eingabetaste im Feld schicken das Formular ab."); Bei Formularen brauchst du preventDefault fast immer. Ohne die Zeile schickt der Browser die Daten ab und lädt die Seite neu, und dann ist alles weg, der Zustand im Speicher, die Anzeige und der halb ausgefüllte Rest.
Der Handler läuft dabei vorher noch durch. Das macht den Fehler so verwirrend. Kurz sieht es so aus, als hätte alles funktioniert, und dann ist die Seite neu.
Abschnitt 13 baut auf dieser einen Zeile auf. Wer ein Formular in JavaScript behandelt, ruft preventDefault auf.
Nicht zu verwechseln
<div id="aussen">
<a id="link" href="details.html">Zu den Details</a>
</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;
}
#aussen {
padding: 12px;
background: #e2e8f0;
} const protokoll = document.getElementById("protokoll");
function notiere(text) {
protokoll.textContent = `${protokoll.textContent}${text}\n`;
}
document.getElementById("link").addEventListener("click", (event) => {
event.preventDefault();
notiere("Link: abgefangen");
});
// Dieser Listener läuft trotzdem. preventDefault sagt nur,
// dass der Browser seine eingebaute Reaktion lassen soll,
// nicht dass das Ereignis hier aufhört.
document.getElementById("aussen").addEventListener("click", (event) => {
notiere(`außen: läuft auch, defaultPrevented = ${event.defaultPrevented}`);
});
console.log("Ein Klick, zwei Zeilen im Protokoll."); preventDefault und stopPropagation klingen verwandt, haben aber mit ganz verschiedenen Dingen zu tun.
preventDefault() sagt dem Browser, er soll seine eingebaute Reaktion lassen. Das Ereignis läuft weiter durch die Seite, und alle anderen Listener laufen ebenfalls.
stopPropagation() hält das Ereignis an, und die Listener weiter oben bekommen es nicht mehr. Am Standardverhalten des Browsers ändert das nichts, und der Link navigiert trotzdem.
Im dritten Beispiel hängt ein Listener innen und einer außen. Der innere fängt das Standardverhalten ab. Der äußere läuft trotzdem und sieht an event.defaultPrevented, dass jemand vor ihm abgefangen hat. Was stopPropagation genau tut und warum man damit sparsam umgeht, kommt in der nächsten Lektion.
return false in altem Code
In alten Anleitungen steht statt preventDefault oft ein return false am Ende des Handlers. Das funktioniert nur in der alten Schreibweise mit onclick, im Markup oder als Eigenschaft el.onclick = ..., und dort tut es genau eine Sache, nämlich preventDefault. Dass es zusätzlich die Weitergabe nach oben stoppt, ist eine Erinnerung an jQuery, denn dort macht return false wirklich beides.
In einem Handler, der mit addEventListener hinterlegt ist, bewirkt return false gar nichts, weil sich dort niemand für den Rückgabewert interessiert. Findest du es in fremdem Code, weißt du zwei Dinge. Es ist alt. Und ob es überhaupt etwas tut, hängt daran, wo es steht.
In der Aufgabe deckt ein Link einen Bereich auf derselben Seite auf, statt zu einer anderen Seite zu führen.
Zum Mitnehmen
preventDefault schaltet die eingebaute Reaktion des Browsers für ein Ereignis ab, bei Formularen fast immer. stopPropagation hält das Ereignis dagegen auf dem Weg nach oben an, und return false wirkt nur in der alten Schreibweise mit onclick.
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.