Abschnitt 13 · Lektion 6
Synthese: das geprüfte Formular
Zweimal schnell auf Absenden gedrückt, und schon ist alles doppelt gespeichert. Das soll nicht passieren. Prüfen, melden und speichern soll das Formular trotzdem. Dafür kommt alles aus diesem Abschnitt in einen Handler, und ob der hält, hängt an der Reihenfolge darin.
Die Reihenfolge
<form id="formular" novalidate>
<p>
<label for="name">Name</label>
<input id="name" name="name" value="" aria-describedby="fehler-name">
<span class="hinweis" id="fehler-name"></span>
</p>
<p>
<label for="email">E-Mail</label>
<input id="email" name="email" value="" aria-describedby="fehler-email">
<span class="hinweis" id="fehler-email"></span>
</p>
<button type="submit">Absenden</button>
</form>
<p id="status"></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");
const felder = [...formular.querySelectorAll("input")];
function melde(feld, meldung) {
document.getElementById(`fehler-${feld.id}`).textContent = meldung;
feld.setAttribute("aria-invalid", meldung !== "" ? "true" : "false");
}
function pruefe(feld) {
const wert = feld.value.trim();
if (wert === "") return "Bitte ausfüllen";
if (feld.id === "email" && !wert.includes("@")) return "Da fehlt ein @";
return "";
}
formular.addEventListener("submit", (event) => {
// 1. Abfangen. Immer als Erstes.
event.preventDefault();
// 2. Prüfen und melden, und zwar ALLE Felder. Nicht beim
// ersten Fehler aufhören, denn wer ausfüllt, will alles
// auf einmal sehen und nicht dreimal hintereinander.
const meldungen = felder.map((feld) => {
const meldung = pruefe(feld);
melde(feld, meldung);
return meldung;
});
// 3. War etwas dabei, hier aufhören.
if (meldungen.some((meldung) => meldung !== "")) {
document.getElementById("status").textContent = "Bitte sieh dir die Meldungen an";
return;
}
// 4. Erst jetzt weiterreichen.
document.getElementById("status").textContent = "Alles in Ordnung";
console.log("hier ginge es zum Server, siehe Abschnitt 16");
});
console.log("Leer abgeschickt melden beide Felder, ausgefüllt ist alles in Ordnung."); Ein submit-Handler sieht immer gleich aus. Die Reihenfolge darin ist keine Geschmacksfrage.
- Abfangen.
preventDefault()steht ganz vorn, bevor irgendetwas schiefgehen kann. Steht es weiter unten und der Code darüber wirft einen Fehler, lädt die Seite neu und nimmt die Fehlermeldung gleich mit. - Alle Felder prüfen und melden, und zwar alle, ohne beim ersten Fehler aufzuhören. Wer drei Felder falsch ausgefüllt hat, will das einmal erfahren und nicht dreimal hintereinander.
- Entscheiden. War eine Meldung dabei, hört der Handler hier auf.
- Erst dann einsammeln und weiterreichen. In diesem Kurs heißt das, das Objekt zu bauen und irgendwo hinzulegen.
Was hier fehlt, ist das Verschicken, und zwar mit Absicht. Ein POST braucht einen Endpoint, also eine Adresse auf dem Server, die Daten annimmt. Der braucht wiederum eine Begrenzung der Anfragen und eine eigene Prüfung auf dem Server, und das alles gehört nicht in eine Übung, in der es um das Formular im Browser geht.
Der Button
<form id="sauber">
<label>Vorname <input name="vorname" value="Ida"></label>
<button type="submit">Sauber</button>
</form>
<form id="kaputt">
<label>Vorname <input name="vorname" value="Ida"></label>
<button type="submit">Bleibt gesperrt</button>
</form>
<p id="status"></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 status = document.getElementById("status");
function speichere(fertig) {
setTimeout(fertig, 800);
}
// Gesperrt, und im Callback wieder frei.
document.getElementById("sauber").addEventListener("submit", (event) => {
event.preventDefault();
const button = event.currentTarget.querySelector("button");
button.disabled = true;
status.textContent = "Speichert";
speichere(() => {
button.disabled = false;
status.textContent = "Gespeichert";
});
});
// Hier wird der Button gesperrt und nie wieder frei, weil
// das Freigeben fehlt. Ein vergessener Fehlerfall sähe
// genauso aus.
document.getElementById("kaputt").addEventListener("submit", (event) => {
event.preventDefault();
event.currentTarget.querySelector("button").disabled = true;
status.textContent = "Speichert und bleibt dabei";
});
console.log("Nach dem ersten Absenden lässt sich nur das obere Formular wieder abschicken."); Solange eine Anfrage läuft, gehört der Absenden-Button gesperrt. Wer nichts passieren sieht, drückt noch einmal, und dann steht die Bestellung zweimal da.
speichere steht im Beispiel für so eine Anfrage. Das setTimeout darin ruft fertig erst nach 800 Millisekunden auf, so wie auch eine echte Antwort vom Server nicht sofort da ist. Wie das genau funktioniert, kommt in Abschnitt 15. Hier zählt nur, dass zwischen Sperren und Freigeben Zeit vergeht.
Zum Sperren gehört das Freigeben, und zwar auf jedem Weg. Der Erfolgsfall ist leicht. Den Fehlerfall vergisst man schnell. Dann bleibt der Button für immer gesperrt. Die Seite sieht aus, als würde sie noch arbeiten, und wer davorsitzt, kann nur noch neu laden.
Im zweiten Beispiel stehen beide Fassungen nebeneinander. Der zweiten fehlt das Freigeben ganz. Genauso sähe auch ein vergessener Fehlerfall aus.
Das passende Werkzeug dafür kommt in Abschnitt 14, denn finally läuft, egal wie der Block ausgegangen ist. Bis dahin steht das Freigeben im Callback, direkt neben dem Code, der fertig meldet.
Die Erfolgsmeldung
<form id="formular">
<label>E-Mail <input name="email" value="ida@example.com"></label>
<button type="submit">Eintragen</button>
</form>
<p id="status" role="status"></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 status = document.getElementById("status");
document.getElementById("formular").addEventListener("submit", (event) => {
event.preventDefault();
const adresse = new FormData(event.currentTarget).get("email");
// Gut: sagt, was passiert ist, mit dem konkreten Wert,
// und sagt, was als Nächstes kommt.
status.textContent = `Eingetragen: ${adresse}. Du bekommst gleich eine Bestätigung.`;
// Weniger gut wären: "Erfolg!", "OK" oder gar nichts.
console.log("Der Bereich trägt role=\"status\" und wird deshalb vorgelesen.");
});
// Der Bereich steht schon im Markup, auch solange er leer
// ist. Ein Element, das erst mit der Meldung entsteht, wird
// von einem Screenreader oft gar nicht angekündigt.
console.log("Das Absenden schreibt die Meldung in den Statusbereich."); Eine gute Erfolgsmeldung sagt, was passiert ist, und zwar mit dem konkreten Wert, also „Eingetragen: ida@example.com“ statt „Erfolg“. So siehst du nebenbei, ob du dich vertippt hast.
Sie sagt auch, was als Nächstes kommt. „Du bekommst gleich eine Bestätigung“ beantwortet die Frage, die sonst offen bleibt. Und sie steht dort, wo man hinschaut, also beim Formular und nicht am Seitenende.
Für Screenreader steht der Bereich für die Meldung schon im Markup, auch solange er leer ist, und trägt role="status". Ein Element, das erst zusammen mit der Meldung entsteht, wird oft gar nicht angekündigt. In Lektion 20.4 geht es darum noch genauer.
Was jetzt fehlt
Das Formular prüft, meldet, sammelt ein und kümmert sich um den Zustand seines Buttons. Nur verschicken tut es nichts.
Dafür fehlen noch zwei Abschnitte. In Abschnitt 15 erfährst du, was der Callback im zweiten Beispiel eigentlich ist und warum Code nicht immer von oben nach unten läuft. In Abschnitt 16 siehst du, wie ein echtes fetch das gespielte Speichern ersetzen würde.
In der Aufgabe verbindest du das vollständige Formular aus Helfern, die schon dastehen.
Zum Mitnehmen
Abfangen, prüfen und melden, bei einer Meldung aufhören, sonst einsammeln und weiterreichen. Der Absenden-Button wird dabei auf jedem Weg wieder freigegeben.
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.