Abschnitt 13 · Lektion 2
Das submit-Ereignis
Nach dem Absenden soll eine Meldung erscheinen. Stattdessen steht die Seite plötzlich wieder auf Anfang. Das Formular hat sich abgeschickt, so wie es das ohne JavaScript eben tut, und die Seite neu geladen. Abfangen kannst du das, wenn der Listener an der richtigen Stelle hängt.
Am Formular, nicht am Button
<form id="richtig">
<label>Vorname <input name="vorname" value="Ida"></label>
<button type="submit">Absenden</button>
</form>
<form id="falsch">
<label>Stadt <input name="stadt" required></label>
<button id="button" type="submit">Absenden</button>
</form>
<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;
}
input,
select,
textarea {
padding: 0.35rem 0.5rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
} const protokoll = document.getElementById("protokoll");
function notiere(text) {
protokoll.textContent = `${protokoll.textContent}${text}\n`;
}
// Der Listener hängt am Formular. Er bekommt jeden Weg mit,
// den Klick auf den Button genauso wie die Eingabetaste im Feld.
document.getElementById("richtig").addEventListener("submit", (event) => {
event.preventDefault();
notiere("richtig: abgefangen");
});
// Dieser Listener hängt am Button. Er hört den Klick auch
// dann, wenn der Browser das Absenden wegen des leeren
// Pflichtfelds gleich danach stoppt.
document.getElementById("button").addEventListener("click", () => {
notiere("falsch: Klick bemerkt, als wäre abgeschickt worden");
});
// Kommt das Absenden wirklich durch, wird es hier abgefangen,
// damit die Seite stehen bleibt.
document.getElementById("falsch").addEventListener("submit", (event) => {
event.preventDefault();
notiere("falsch: wirklich abgeschickt");
});
console.log("Die Eingabetaste im ersten Formular und ein Klick auf Absenden im zweiten schreiben ins Protokoll."); Das Ereignis heißt submit und feuert am <form>.
Der Reflex, es an den Absenden-Button zu hängen, ist verständlich und trotzdem falsch, denn ein Formular lässt sich auf mehreren Wegen abschicken.
- ein Klick auf den Absenden-Button,
- die Eingabetaste in einem Textfeld,
- ein
form.requestSubmit()aus dem Code.
Ein Listener am Button hört auf den Klick, und das reicht nicht. Die Eingabetaste im Feld erreicht ihn zwar, denn der Browser löst dafür einen Klick auf den Absenden-Button aus, solange es einen gibt. Ein requestSubmit() aus dem Code kommt aber ganz ohne Klick aus. Und der Klick feuert auch dann, wenn der Browser das Absenden gleich danach stoppt, weil ein Pflichtfeld leer ist.
Der Listener am Formular bekommt genau die Fälle, in denen wirklich abgeschickt wird. Einen Fall, in dem der Button die bessere Stelle wäre, gibt es nicht.
preventDefault ist hier Pflicht
Ohne event.preventDefault() schickt der Browser das Formular ab und lädt die Seite neu. Der Handler läuft vorher noch komplett durch, und deshalb sieht es einen Moment lang so aus, als hätte alles geklappt.
Das ist der Fall aus Lektion 12.4, nur ist er hier der Normalfall statt der Ausnahme. Jeder submit-Handler in diesem Kurs fängt deshalb mit preventDefault an.
Fehlt die Zeile im Beispiel, siehst du nach dem Absenden im Reiter „Netzwerk“ die Anfrage für das Formular, mit den Feldern als Paare in der Adresse. Und die Seite steht wieder auf Anfang, weil sie neu geladen wurde.
Das eingebaute Absenden ist nichts Schlechtes. Ein Formular, das ohne JavaScript an den Server geht, funktioniert auch dann noch, wenn das Skript ausfällt. Wer es abfängt, ist für alles verantwortlich, was danach kommt, und wie das Verschicken dann aussieht, steht in Abschnitt 16.
Der Standard-type eines button
<form id="formular">
<label>Vorname <input name="vorname" value="Ida"></label>
<button id="ohne">ohne type-Angabe</button>
<button id="mit" type="button">type="button"</button>
<button id="absenden" type="submit">type="submit"</button>
</form>
<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;
}
input,
select,
textarea {
padding: 0.35rem 0.5rem;
border: 1px solid #d6d3d1;
border-radius: 6px;
} const protokoll = document.getElementById("protokoll");
function notiere(text) {
protokoll.textContent = `${protokoll.textContent}${text}\n`;
}
// Ein button ohne type-Angabe ist ein Absenden-Button. Das
// überrascht, besonders bei einem Button, der
// eigentlich nur etwas ein- und ausklappen soll.
console.log("ohne Angabe:", document.getElementById("ohne").type);
console.log("mit Angabe:", document.getElementById("mit").type);
console.log("ausdrücklich:", document.getElementById("absenden").type);
document.getElementById("formular").addEventListener("submit", (event) => {
event.preventDefault();
notiere("abgeschickt");
});
document.getElementById("mit").addEventListener("click", () => {
notiere("nur geklickt, kein Absenden");
});
console.log("Zwei der drei Buttons schicken ab, einer nicht."); Ein <button> ohne type-Angabe ist ein Absenden-Button. Der Standard ist submit, nicht button.
Das überrascht an einer ungünstigen Stelle. Ein Button mitten im Formular, der eigentlich nur einen Bereich aufklappen soll, schickt beim Klick das ganze Formular ab und lädt die Seite neu.
Jeder Button innerhalb eines Formulars, der nicht absenden soll, bekommt deshalb ausdrücklich type="button". In diesem Kurs steht das überall dran, auch außerhalb von Formularen, damit die Gewohnheit sitzt.
Es gibt noch type="reset", das setzt das Formular zurück. Hier kommt es nicht vor. Ein Button, der aus Versehen alle Eingaben löscht, ist selten das, was jemand wollte.
Aufräumen nach dem Absenden
<form id="formular">
<label>Name <input id="frei" name="name" value=""></label>
<label>Stadt <input id="vorbelegt" name="stadt" value="Leipzig"></label>
<button type="submit">Absenden</button>
</form>
<p id="ausgabe">noch nichts</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 formular = document.getElementById("formular");
formular.addEventListener("submit", (event) => {
event.preventDefault();
const wert = document.getElementById("frei").value;
document.getElementById("ausgabe").textContent = `Bekommen: "${wert}"`;
// reset setzt auf den Stand aus dem MARKUP zurück, nicht
// auf leer. Das zweite Feld steht danach wieder auf seinem
// Anfangswert.
formular.reset();
console.log("frei:", JSON.stringify(document.getElementById("frei").value));
console.log("vorbelegt:", JSON.stringify(document.getElementById("vorbelegt").value));
});
console.log("Nach dem Absenden steht das zweite Feld wieder auf seinem Anfangswert."); formular.reset() setzt alle Felder zurück, und zwar auf den Stand aus dem Markup, nicht auf leer. Ein Feld mit value="Leipzig" steht danach wieder genau darauf.
Meistens will man das auch so. Willst du wirklich leeren, setzt du die Werte selbst.
Ob überhaupt zurückgesetzt wird, hängt vom Zweck ab. Eine Eingabe, die man einmal macht, darf verschwinden. Ein Filter, den man nachjustiert, sollte stehen bleiben. Und wenn etwas schiefgeht, wird der Inhalt auf keinen Fall gelöscht, denn nach einer Fehlermeldung füllt niemand gern das ganze Formular noch einmal von vorn aus.
In der Aufgabe fängst du ein Formular ab, das sich mit dem eingegebenen Namen bedankt und danach leert.
Zum Mitnehmen
submit hängt am Formular und feuert genau dann, wenn wirklich abgeschickt wird, und preventDefault hält die Seite fest. Ein button ohne type schickt ab, und reset setzt auf den Stand aus dem Markup zurück.
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.