Docusaurus-Umfrageformular
Füge deinen Docusaurus-Docs eine kurze Umfrage hinzu, ganz ohne Plugin. Nutze Dropdowns für schnelle Antworten und ein offenes Feld, füge sie in eine MDX-Seite ein, und die Antworten landen in deinem Posteingang. Kein eigenes Backend.
So baust du es
- Erstelle ein Formular in deinem Formpaste-Dashboard und kopiere den Zugangsschlüssel.
- Füge das Markup in eine .mdx-Seite ein und benenne class in className um.
- Ersetze YOUR_ACCESS_KEY_HERE durch deinen Zugangsschlüssel, dann deploye.
Docusaurus-Fallstricke
Docusaurus-Seiten sind MDX, ein Formpaste-Formular ist also Markup, das du direkt ins Dokument einfügst. Es gibt kein Plugin zu installieren und kein Theme zu swizzeln. Der einzige Haken: MDX behandelt Markup als JSX, das eingefügte Snippet braucht also className statt class.
MDX ist JSX, also className statt class
In einer .mdx-Datei ist alles, was wie HTML aussieht, in Wirklichkeit JSX. Benenne class im eingefügten Formular in className um und schreibe jedes Inline-Style als Objekt wie style={{marginTop: '1rem'}} statt als String. Das ungestylte CSS-Snippet lässt sich am einfachsten anpassen.
Kein Plugin und kein Swizzling
Du brauchst weder ein Docusaurus-Plugin noch musst du eine Theme-Komponente swizzeln. Ein Formular im Seiteninhalt funktioniert in den Docs, im Blog und auf eigenständigen Seiten gleichermaßen.
Bei Wiederholung in eine Komponente auslagern
Wenn dasselbe Formular auf vielen Seiten stehen soll, leg es als .jsx- oder .tsx-Datei in src/components/ ab und importiere es in jedes Dokument. Das ist das Muster, das die Docusaurus-Docs für alles jenseits einer Einzelverwendung empfehlen, und es hält das Markup aus deinem Fließtext heraus.
Das versteckte access_key behalten
Lass das generierte versteckte access_key-Input-Feld unverändert stehen, damit Formpaste weiß, zu welchem Formular die Einsendung gehört. Es ist ein normales Input-Feld und übersteht den Umzug in eine Komponente unverändert.
Worauf es ankommt
Kurz halten für eine hohe Abschlussquote
Jede zusätzliche Frage kostet Antworten. Ein paar Dropdowns und ein offenes Kommentarfeld liefern meist alles, was du brauchst, ohne Ermüdung.
Dropdowns schlagen Freitext bei der Auswertung
Feste Auswahlmöglichkeiten (Select-Felder) lassen sich später leicht auszählen. Heb dir das Textfeld für die eine offene Frage auf, die es wirklich braucht.
Mach die E-Mail optional für ehrliche Antworten
Anonyme Antworten sind oft ehrlicher. Frag nur nach der E-Mail, wenn du nachfassen musst, und markiere sie als optional.
So funktioniert es
Drei einfache Schritte, bis Formular-Einsendungen in deinem E-Mail-Posteingang landen.
Erstelle dein Formular, setze die action-URL auf den Formpaste-Endpunkt und trage deinen Zugangsschlüssel ein.
Formular erstellen
Melde dich an, verifiziere deine E-Mail und erstelle einen Zugangsschlüssel im Dashboard.
Code kopieren
Füge das Snippet oben in dein Projekt ein. Wähle CSS oder Tailwind passend zu deiner Website.
<form action="https://api.formpaste.com/submit" method="POST" class="mx-auto flex w-full max-w-md flex-col gap-4 rounded-xl border border-gray-200 bg-white p-6 shadow-sm dark:border-gray-800 dark:bg-gray-950">
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">E-Mail (optional)
<input type="email" name="email" placeholder="du@beispiel.de" class="rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm outline-none focus-visible:ring-2 focus-visible:ring-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:focus-visible:ring-gray-100" />
</label>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Was trifft am besten auf dich zu?
<select name="role" required class="rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm outline-none focus-visible:ring-2 focus-visible:ring-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:focus-visible:ring-gray-100">
<option>Entwickler</option>
<option>Designer</option>
<option>Gründer</option>
<option>Sonstiges</option>
</select>
</label>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Wie zufrieden bist du?
<select name="satisfaction" required class="rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm outline-none focus-visible:ring-2 focus-visible:ring-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:focus-visible:ring-gray-100">
<option>Sehr zufrieden</option>
<option>Zufrieden</option>
<option>Neutral</option>
<option>Unzufrieden</option>
</select>
</label>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Möchtest du noch etwas ergänzen?
<textarea name="comments" class="min-h-28 rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm outline-none focus-visible:ring-2 focus-visible:ring-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:focus-visible:ring-gray-100"></textarea>
</label>
<button type="submit" class="w-full rounded-md bg-gray-900 px-4 py-2 text-sm font-medium text-white shadow-sm transition-colors hover:bg-gray-800 disabled:opacity-60 dark:bg-white dark:text-gray-900 dark:hover:bg-gray-200">Umfrage absenden</button>
</form>Zugangsschlüssel hinzufügen
Ersetze den Platzhalter durch deinen Zugangsschlüssel, um Einsendungen zu empfangen.
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">Docusaurus-Umfrageformular FAQ
Formular einfügen. Einsendungen erhalten.
Sofort, ohne Backend, Server oder Datenbanken einzurichten. 250 Einsendungen/Monat kostenlos - keine Kreditkarte.