Formulare

Form Steps

Ein Webflow-Formular in mehrere Schritte teilen — mit Verzweigung, eigenen Fehlertexten und Auswahl-Kacheln.

v1.1.010 kB gzipkostenlos

Live-Demo ansehenCloneable holenTutorial-Video
Auf dieser Seite

Skript einbinden

Head Code · im <head>
<!-- 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"
      └─ Submit
Beispiel
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

Form Block oder Form

Schaltet die Lösung für dieses Formular ein.

Div-Block im Formular

Macht den Div-Block zu einem Schritt.

Button · Link Block · Submit

Weiter. Prüft vorher den sichtbaren Schritt und bleibt stehen, wenn etwas fehlt.

Button · Link Block · Submit

Zurück. Ohne Prüfung, und folgt dem tatsächlich gegangenen Weg — auch nach einem Sprung.

Button · Link Block · Submit

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.

Bedingung und Sprungziel

Der Schritt gehört nur zum Weg, wenn der Ausdruck wahr ist.

Bedingung und Sprungziel

Ziel-ID für Sprünge.

Bedingung und Sprungziel

Standard-Ziel nach diesem Schritt.

Radio · Checkbox · Option · Weiter-Knopf

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

Am Formular oder am einzelnen Schritt

Beim Klick auf Weiter wird der sichtbare Schritt geprüft.

Standard: step
Am Formular oder am einzelnen Schritt

Zusätzlich beim Verlassen eines Felds — der Fehler steht sofort, nicht erst am Schrittende.

Am Formular oder am einzelnen Schritt

Erst beim Absenden, dafür über alle Schritte des gegangenen Wegs.

Am Formular oder am einzelnen Schritt

Keine eigene Prüfung.

Wo der Fehler steht

Text-Block im Formular

Trägt den Fehlertext.

Text-Block im Formular

Bindet das Element an ein bestimmtes Feld (dessen name oder id) oder an eine Gruppe.

Text-Block im Formular

Optionaler Wrapper um Label, Feld und Fehler.

Text-Block im Formular

Zusammenfassung oben im Schritt: eine Liste aller Fehler, jeder Eintrag springt zum Feld.

Was der Fehler sagt

Am Feld, sonst am Formular

Pflichtfeld ist leer.

Am Feld, sonst am Formular

Auch -url, -tel, -number und -pattern gibt es.

Am Feld, sonst am Formular

Dazu -maxlength, -min, -max und -step. {min} und {max} setzen die Grenze ein.

Am Feld, sonst am Formular

Eine Meldung für jeden Fehler dieses Felds — praktisch, wenn ein Feld nur einen Fehlerfall hat.

Am Feld, sonst am Formular

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.

Anzeige-Elemente

Fortschrittsbalken.

Anzeige-Elemente

Zähler-Text. Standard „Schritt {current} von {total}“.

Anzeige-Elemente

Eigenes Zähler-Format.

Anzeige-Elemente

Anzeigename des Schritts.

Anzeige-Elemente

Zeigt den Namen des aktuellen Schritts (fpu-form-step-name).

Anzeige-Elemente

Ein Punkt bzw.

Anzeige-Elemente

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

Div-Block mit Radio oder Checkbox darin

Die ganze Fläche wird klickbar.

Gruppe aus Radios oder Checkboxen

Div-Block um alle Antworten

Fasst die Antworten zu einer Einheit zusammen.

Div-Block um alle Antworten

Mindestens eine Auswahl.

Div-Block um alle Antworten

Mindestzahl an Haken bei Checkbox-Gruppen.

Div-Block um alle Antworten

Höchstzahl an Haken bei Checkbox-Gruppen.

Div-Block um alle Antworten

Name der Gruppe.

Div-Block um alle Antworten

Eigener Text für die Gruppe.

Div-Block um alle Antworten

Nach der Radio-Auswahl automatisch weiter.

Div-Block um alle Antworten

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
Am Formular

Eingaben und den erreichten Schritt in der Sitzung sichern und beim Zurückkommen wiederherstellen.

Standard: false
Am Formular

Bei jedem Schrittwechsel an den Anfang des Formulars scrollen.

Standard: false
Am Formular

Verbindet Elemente außerhalb des Formulars — Fortschritt, Zähler, Indikatoren, Knöpfe — mit genau diesem Formular.

Am Formular

Eine Zeile in der Konsole beim Start: Version, Anzahl Schritte, Prüfmodus.

Standard: false
Globale 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.

Zugang derzeit nur auf Einladung