Formulaire de contact pour Next.js

Formgong team ·

Collez ceci dans Next.js. Les envois partent vers Formgong. Pas de base de données, pas de Resend.

250 envois gratuits par mois

Comment fonctionnent les formulaires dans Next.js

Dans l’App Router, la méthode native pour gérer un formulaire consiste à utiliser une action serveur ou un gestionnaire de route, qui appelle généralement une API de messagerie électronique à l’aide d’une clé secrète. Cela nécessite un environnement d’exécution serveur, et les actions serveur ne sont pas prises en charge lorsque vous exportez le site via output: 'export'.

Un composant client qui envoie les données à https://formgong.com/submit n’a besoin d’aucune de ces informations. Il fonctionne sur Vercel, sur n’importe quel hébergeur Node et en tant qu’exportation statique, et chaque prospect est transmis par e-mail et via Telegram, avec une copie dans la boîte de réception Formgong.

Mise en place dans Next.js

  1. Créez un formulaire dans Formgong et copiez la clé d’accès.
  2. Ajoutez le composant ci-dessous. Il commence par « "use client" » car il gère un événement du navigateur.
  3. Remplacez la clé ou récupérez-la à partir d’une variable « NEXT_PUBLIC_ » ; seules ces dernières sont accessibles au code du navigateur.
  4. Affichez le composant sur votre page, lancez next dev et envoyez un test.
  5. Vous préférez une solution prête à l’emploi ? @formgong/react vous propose une solution prête à l’<ContactForm> et le starter Next.js disponible sur GitHub est un projet complet.
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: "fr", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Envoyé. Merci !" : "Échec de l’envoi. Veuillez réessayer."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Nom <input name="name" placeholder="Votre nom" required /></label>
      <label>E-mail <input name="email" type="email" placeholder="vous@exemple.com" required /></label>
      <label>Message <textarea name="message" placeholder="Comment pouvons-nous vous aider ?" 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">Envoyer</button>
      <p role="status">{status}</p>
    </form>
  );
}

Starter prêt à l’emploi sur GitHub: github.com/formgong/nextjs-starter. Licence MIT : cliquez sur « Use this template » ou copiez les fichiers.

Nouveau projet en une commande: npm create formgong@latest -- --template nextjs (npm: create-formgong)

Paquet de composants: npm install @formgong/next (npm: @formgong/next)

Ajouter à un projet existant: npx formgong init (npm: formgong)

Formgong ou une action serveur ?

Rédigez une action serveur lorsque la soumission doit modifier vos données ou vérifier l’identité d’un utilisateur connecté.

Utilisez Formgong pour vos formulaires de contact, de devis et de prospects : pas de fournisseur de messagerie, pas de secrets et pas de gestion des spams dans votre code source.

Questions et réponses

Puis-je utiliser une action serveur comme intermédiaire pour masquer la clé ?

Vous pouvez le faire, mais il n’y a rien à cacher : la clé est publique. Un proxy fait également en sorte que chaque soumission provienne de l’adresse IP de votre serveur, ce qui atténue les limites de débit et les signaux de spam.

Cela fonctionne-t-il avec l'exportation statique ?

Oui. Un composant client qui envoie des données à Formgong ne nécessite pas de serveur, tandis que les actions serveur ne sont pas prises en charge dans l’exportation statique.

Pages Router ou App Router ?

Les deux. Dans le routeur de pages, supprimez la ligne « "use client" » ; le reste reste inchangé.

Faut-il Resend ou une Server Action ?

Pas pour un formulaire de contact. Resend exige un domaine vérifié et des enregistrements DNS, et la clé API reste sur le serveur. Écrivez une Server Action quand l’envoi doit modifier votre base ou vérifier un utilisateur connecté.

Comment arrêter le spam sur un formulaire Next.js ?

Laissez botcheck vide. Formgong marque un honeypot rempli comme spam et ne l’envoie ni par e-mail ni sur Telegram. Turnstile est facultatif. Ajoutez le widget seulement après l’avoir activé dans les réglages du formulaire. Le secret reste chez Formgong.

Commencer gratuitement