Formulare
Form Steps
Ein Webflow-Formular in mehrere Schritte teilen — mit Verzweigung, eigenen Fehlertexten und Auswahl-Kacheln.
Auf dieser Seite
Skript einbinden
<!-- FlowPowerUser · Form Steps -->
<script defer src="https://cdn.jsdelivr.net/npm/@flowpoweruser/attributes@1/form-steps.js"></script>Einmal pro Projekt genügt, auch wenn du die Lösung auf mehreren Seiten nutzt: Project Settings → Custom Code → Head Code.
Das Skript lädt nebenher und hält das Rendern nicht auf; es läuft erst, wenn die Seite steht, und tut nichts, solange kein fpu-Attribut da ist.
Aufbau wählen
Jeder Schritt ist ein gewöhnlicher Div-Block im Formular.
Du baust alle Schritte untereinander im Designer — sichtbar wird immer nur einer. Zwei Wege sind üblich:
Beispiel
Form Block fpu-form-element="form"
└─ Form
├─ Div Schritt 1 fpu-form-element="step"
├─ Div Schritt 2 fpu-form-element="step"
├─ Div Schritt 3 fpu-form-element="step"
└─ Div Knopfleiste
├─ Button fpu-form-element="prev"
├─ Button fpu-form-element="next"
└─ SubmitBeispiel
Div Wer bist du? fpu-form-element="step"
fpu-form-step-id="art"
Div Firmendaten fpu-form-element="step"
fpu-form-step-if="kundenart=firma"
Div Privatdaten fpu-form-element="step"
fpu-form-step-if="kundenart=privat"
Div Absenden fpu-form-element="step"Nötige Attribute setzen
Schaltet die Lösung für dieses Formular ein.
Macht den Div-Block zu einem Schritt.
Weiter. Prüft vorher den sichtbaren Schritt und bleibt stehen, wenn etwas fehlt.
Zurück. Ohne Prüfung, und folgt dem tatsächlich gegangenen Weg — auch nach einem Sprung.
Absenden. Nur im letzten Schritt aktiv.
Ergebnis im Markup
<form fpu-form-element="form">
<div fpu-form-element="step" fpu-form-step-name="Kontakt">
<input name="e-mail" type="email" required>
</div>
<div fpu-form-element="step" fpu-form-step-name="Projekt">
<textarea name="projekt" required></textarea>
</div>
<button fpu-form-element="prev">Zurück</button>
<button fpu-form-element="next">Weiter</button>
<input type="submit" value="Absenden">
</form>Zwei Wege führen zum Ziel, und sie lassen sich mischen.
Eine Bedingung am Schritt entscheidet, ob der Schritt überhaupt zum Weg gehört. Ein Sprungziel an der Antwort schickt direkt zu einem bestimmten Schritt. Übersprungene Schritte zählen weder im Fortschritt noch im Zähler, werden nicht geprüft und ihre Felder werden abgeklemmt — sie landen also auch nicht im Submit.
Der Schritt gehört nur zum Weg, wenn der Ausdruck wahr ist.
Ziel-ID für Sprünge.
Standard-Ziel nach diesem Schritt.
Ist diese Antwort gewählt, geht Weiter direkt zu dem Schritt mit dieser ID.
Drei Antworten, drei Wege
<!-- Schritt 2: die Auswahl -->
<div fpu-form-element="step" fpu-form-step-id="auswahl">
<label><input type="radio" name="ziel" value="website"> Website</label>
<label><input type="radio" name="ziel" value="shop"> Onlineshop</label>
<label><input type="radio" name="ziel" value="support"> Support</label>
</div>
<!-- Danach kommt nur, was zur Antwort passt -->
<div fpu-form-element="step" fpu-form-step-if="ziel=website">…</div>
<div fpu-form-element="step" fpu-form-step-if="ziel=shop">…</div>
<div fpu-form-element="step" fpu-form-step-if="ziel=support">…</div>
<!-- Immer am Ende -->
<div fpu-form-element="step" fpu-form-step-id="absenden">…</div>Ausdrücke in step-ifgleiche Syntax wie fpu-condition
plan=pro- Gleichheit, Groß- und Kleinschreibung egal, Zahlen werden als Zahlen verglichen.
plan!=basic- Ungleichheit.
plan=basic|pro- Mehrere erlaubte Werte für dasselbe Feld.
menge>=5- Zahlvergleich, auch mit <, > und <=. „19,99“ wird verstanden.
newsletter- Nur der Feldname: wahr, sobald das Feld angehakt oder gefüllt ist.
plan=pro && menge>=5- UND — beide Teile müssen stimmen.
plan=pro || plan=team- ODER — bindet schwächer als UND, klammert also die UND-Gruppen.
Veröffentlichen und prüfen
Attribute wirken erst auf der veröffentlichten Seite — im Designer bleibt der Stapel aus Schritten sichtbar, das ist richtig so.
Passiert nichts, hilft fpu-form-logging=„true“ am Formular: die Konsole meldet dann in einer Zeile, wie viele Schritte gefunden wurden und wie viele davon gerade zum Weg gehören.
Optional
Eigene Fehlertexte statt der Browser-SprechblaseFehlertexte einrichten
Ohne Zutun prüft die Lösung beim Weiter alle sichtbaren Felder des Schritts und zeigt die Browser-Sprechblase.
Sobald du irgendwo im Formular ein Fehler-Element setzt, wandert der Text dorthin — gestaltet im Designer, sichtbar nur im Fehlerfall. Was geprüft wird, kommt weiter aus den gewohnten Webflow-Feldeinstellungen (Required, Typ, Muster, Länge).
Wann geprüft wird
Beim Klick auf Weiter wird der sichtbare Schritt geprüft.
Standard: stepZusätzlich beim Verlassen eines Felds — der Fehler steht sofort, nicht erst am Schrittende.
Erst beim Absenden, dafür über alle Schritte des gegangenen Wegs.
Keine eigene Prüfung.
Wo der Fehler steht
Trägt den Fehlertext.
Bindet das Element an ein bestimmtes Feld (dessen name oder id) oder an eine Gruppe.
Optionaler Wrapper um Label, Feld und Fehler.
Zusammenfassung oben im Schritt: eine Liste aller Fehler, jeder Eintrag springt zum Feld.
Was der Fehler sagt
Pflichtfeld ist leer.
Auch -url, -tel, -number und -pattern gibt es.
Dazu -maxlength, -min, -max und -step. {min} und {max} setzen die Grenze ein.
Eine Meldung für jeden Fehler dieses Felds — praktisch, wenn ein Feld nur einen Fehlerfall hat.
Klartextname für {label}.
Ein Feld mit eigenem Fehlertext
<div fpu-form-element="field">
<label for="mail">E-Mail</label>
<input id="mail" name="e-mail" type="email" required
fpu-form-label="deine E-Mail"
fpu-form-message-required="Ohne {label} können wir nicht antworten."
fpu-form-message-email="Da fehlt noch das @.">
<div fpu-form-element="error" fpu-form-error-for="e-mail"></div>
</div>Fortschritt, Zähler und IndikatorenBalken, „Schritt 2 von 4“, Punktleiste
Alle drei rechnen mit dem aktuellen Weg: Fällt ein Schritt durch eine Verzweigung weg, zählt er nirgends mit.
Die Elemente dürfen auch außerhalb des Formulars liegen — dann verbindet sie fpu-form-instance mit dem richtigen Formular.
Fortschrittsbalken.
Zähler-Text. Standard „Schritt {current} von {total}“.
Eigenes Zähler-Format.
Anzeigename des Schritts.
Zeigt den Namen des aktuellen Schritts (fpu-form-step-name).
Ein Punkt bzw.
Bindet einen Indikator fest an eine Step-ID.
Eigene Auswahl-Elemente: Radios, Checkboxen, DropdownsKacheln, Gruppen-Pflicht, Auto-Weiter
Webflow kann Radios und Checkboxen gestalten, aber nicht als ganze Kachel klickbar machen und nicht „mindestens eine Auswahl“ erzwingen.
Genau das ergänzt diese Lösung. Für gestaltete Dropdowns bleibt das native Select das Formularfeld — kombiniere es mit fpu-select (Custom Form Select); Fokus und Fehlermarkierung landen dann automatisch auf dem sichtbaren Auslöser.
Auswahl-Kachel
Die ganze Fläche wird klickbar.
Gruppe aus Radios oder Checkboxen
Fasst die Antworten zu einer Einheit zusammen.
Mindestens eine Auswahl.
Mindestzahl an Haken bei Checkbox-Gruppen.
Höchstzahl an Haken bei Checkbox-Gruppen.
Name der Gruppe.
Eigener Text für die Gruppe.
Nach der Radio-Auswahl automatisch weiter.
Verzögerung in Millisekunden, damit die Auswahl noch kurz sichtbar bleibt.
Pflicht-Auswahl mit Kacheln
<div fpu-form-element="group"
fpu-form-group="ziel"
fpu-form-required="true"
fpu-form-auto-next="true"
fpu-form-label="ein Ziel"
fpu-form-message-group-required="Bitte wähl aus, worum es geht.">
<label fpu-form-element="choice">
<input type="radio" name="ziel" value="website" fpu-form-goto="website">
<span>Neue Website</span>
</label>
<label fpu-form-element="choice">
<input type="radio" name="ziel" value="shop" fpu-form-goto="shop">
<span>Onlineshop</span>
</label>
<div fpu-form-element="error" fpu-form-error-for="ziel"></div>
</div>Weitere EinstellungenZwischenspeichern, Scrollen, mehrere Formulare
Eingaben und den erreichten Schritt in der Sitzung sichern und beim Zurückkommen wiederherstellen.
Standard: falseBei jedem Schrittwechsel an den Anfang des Formulars scrollen.
Standard: falseVerbindet Elemente außerhalb des Formulars — Fortschritt, Zähler, Indikatoren, Knöpfe — mit genau diesem Formular.
Eine Zeile in der Konsole beim Start: Version, Anzahl Schritte, Prüfmodus.
Standard: falseGlobale Standards für alle Formulare
<script>
window.fpuFormStepsConfig = {
persist: true,
scroll: true,
validate: "live",
countTemplate: "Schritt {current} von {total}",
messages: {
required: "Das brauchen wir noch.",
email: "Bitte eine gültige E-Mail.",
},
};
</script>Tastatur, Klassen und Eventsfür Animationen und eigenes Skript
Enter in einem Feld heißt Weiter statt Absenden, außer im letzten Schritt.
Alt+Pfeil rechts und links blättern, solange der Fokus nicht in einem Textfeld oder Dropdown liegt. Nach jedem Wechsel springt der Fokus auf das erste Feld des neuen Schritts.
Klassen, die du stylen kannst
fpu-form-step-active- Der gerade sichtbare Schritt.
fpu-form-step-skipped- Ein Schritt, der durch eine Verzweigung gerade nicht zum Weg gehört.
fpu-form-invalid- Am fehlerhaften Feld.
fpu-form-field-invalid- Am Feld-Wrapper und an der Gruppe.
fpu-form-choice-selected- An der gewählten Auswahl-Kachel.
fpu-form-btn-disabled- An Knöpfen, die im aktuellen Schritt nichts tun können.
Events auf document
fpu:form-step-changed- Nach jedem Wechsel. detail: form, index, total, stepId, stepIndex.
fpu:form-invalid- Für jede gezeigte Meldung. detail: form, element, message.
fpu:form-valid- Wenn ein Absenden die Prüfung bestanden hat und durchgelassen wird.
Das Prinzip
Form Steps macht aus einem gewöhnlichen Webflow-Formular ein Formular mit mehreren Schritten. Das Formular bleibt ein Webflow-Formular: Submit, Erfolgs- und Fehlermeldung, Zapier, Make und alle Integrationen laufen unverändert weiter. Neu ist nur, was zwischen dem ersten Feld und dem Absenden passiert.
- Verzweigung: Die Antwort in Schritt 2 entscheidet, welche Schritte danach überhaupt vorkommen.
- Eigene Fehlertexte statt der Browser-Sprechblase, pro Feld oder pro Formular.
- Pflichtfelder gelten schrittweise: Weiter geht erst, wenn der sichtbare Schritt vollständig ist.
Zusätzliche Features
- Webflow-Submit bleibt unangetastetDie Prüfung läuft vor Webflows eigenem Handler. Ungültige oder verfrühte Absendeversuche erreichen Webflow nie — Erfolgsmeldung, Fehlermeldung und alle angebundenen Dienste verhalten sich wie immer.
- Zurück folgt dem echten WegNach einem Sprung führt Zurück dorthin, wo man tatsächlich herkam, nicht zum vorherigen Element im Designer.
- Aufräumbarwindow.fpuFormSteps.destroyAll() nimmt alle Listener, Klassen und ARIA-Attribute zurück und stellt den Ausgangszustand her — für Seitenübergänge und Single-Page-Umgebungen.
- Barrierefrei von Haus ausSchritte sind Gruppen mit Namen, inaktive Schritte sind inert und für Screenreader weg, der Fortschritt ist eine Progressbar, Fehler werden als Alert angekündigt und mit aria-describedby ans Feld gehängt.