Kontaktformular für Next.js

Formgong team ·

Fügen Sie das in Next.js ein. Einsendungen gehen an Formgong. Keine Datenbank, kein Resend.

250 Einsendungen pro Monat gratis

So funktionieren Formulare in Next.js

Im App Router ist der native Weg für ein Formular eine Server Action oder ein Route Handler, der meist eine E-Mail-API mit geheimem Schlüssel aufruft. Das braucht eine Server-Laufzeit, und Server Actions werden nicht unterstützt, wenn Sie die Seite mit output: 'export' exportieren.

Eine Client-Komponente, die an https://formgong.com/submit sendet, braucht nichts davon. Sie läuft auf Vercel, bei jedem Node-Hoster und als statischer Export, und jede Anfrage geht per E-Mail und an Telegram, mit einer Kopie im Formgong-Posteingang.

Einrichtung in Next.js

  1. Legen Sie in Formgong ein Formular an und kopieren Sie den Zugriffsschlüssel.
  2. Fügen Sie die Komponente unten hinzu. Sie beginnt mit "use client", weil sie ein Browser-Ereignis verarbeitet.
  3. Ersetzen Sie den Schlüssel oder lesen Sie ihn aus einer NEXT_PUBLIC_-Variable; nur diese erreichen den Browser-Code.
  4. Rendern Sie die Komponente auf Ihrer Seite, starten Sie next dev und senden Sie einen Test.
  5. Lieber ein Paket? @formgong/react liefert ein fertiges <ContactForm>, und der Next.js-Starter auf GitHub ist ein komplettes Projekt.
Next.js
"use client";
import { useState } from "react";

export function ContactForm() {
  const [status, setStatus] = useState("");
  async function onSubmit(event) {
    event.preventDefault();
    const fields = Object.fromEntries(new FormData(event.currentTarget));
    const response = await fetch("https://formgong.com/submit", {
      method: "POST",
      headers: { "Content-Type": "application/json", Accept: "application/json" },
      body: JSON.stringify({ _lang: "de", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Gesendet. Vielen Dank!" : "Das Senden ist fehlgeschlagen. Bitte versuchen Sie es erneut."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Name <input name="name" placeholder="Ihr Name" required /></label>
      <label>E-Mail <input name="email" type="email" placeholder="name@beispiel.de" required /></label>
      <label>Nachricht <textarea name="message" placeholder="Wie können wir Ihnen helfen?" required /></label>
      <div aria-hidden="true" style={{ position: "absolute", insetInlineStart: 0, top: 0, width: 1, height: 1, overflow: "hidden", clipPath: "inset(50%)" }}>
        <input name="botcheck" tabIndex={-1} autoComplete="off" />
      </div>
      <button type="submit">Senden</button>
      <p role="status">{status}</p>
    </form>
  );
}

Fertiges Starter-Projekt auf GitHub: github.com/formgong/nextjs-starter. MIT-Lizenz: Klicken Sie auf „Use this template“ oder kopieren Sie die Dateien.

Neues Projekt mit einem Befehl: npm create formgong@latest -- --template nextjs (npm: create-formgong)

Komponenten-Paket: npm install @formgong/next (npm: @formgong/next)

Zu einem bestehenden Projekt hinzufügen: npx formgong init (npm: formgong)

Formgong oder eine Server Action?

Schreiben Sie eine Server Action, wenn die Einsendung Ihre Daten ändern oder einen angemeldeten Nutzer prüfen muss.

Nutzen Sie Formgong für Kontakt-, Angebots- und Lead-Formulare: kein E-Mail-Anbieter, keine Secrets und keine Spam-Abwehr in Ihrer Codebasis.

Fragen und Antworten

Kann ich über eine Server Action proxen, um den Schlüssel zu verbergen?

Können Sie, aber es gibt nichts zu verbergen: Der Schlüssel ist öffentlich. Ein Proxy lässt außerdem jede Einsendung von der IP Ihres Servers kommen, was Limits und Spam-Signale schwächt.

Funktioniert das mit statischem Export?

Ja. Eine Client-Komponente, die an Formgong sendet, braucht keinen Server, während Server Actions im statischen Export nicht unterstützt werden.

Pages Router oder App Router?

Beides. Im Pages Router lassen Sie die Zeile "use client" weg; der Rest ist gleich.

Brauche ich Resend oder eine Server Action?

Nicht für ein Kontaktformular. Resend braucht eine bestätigte Domain und DNS-Einträge, und der API-Schlüssel bleibt auf dem Server. Schreiben Sie eine Server Action, wenn die Einsendung Ihre Datenbank ändern oder eine angemeldete Person prüfen muss.

Wie stoppe ich Spam in einem Next.js-Formular?

Lassen Sie botcheck leer. Formgong wertet ein gefülltes Honeypot als Spam und sendet es weder per E-Mail noch an Telegram. Turnstile ist optional. Das Widget fügen Sie erst hinzu, nachdem Sie es in den Formulareinstellungen eingeschaltet haben. Das Geheimnis bleibt bei Formgong.

Kostenlos starten