Formulaire de contact pour Nuxt

Formgong team ·

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

250 envois gratuits par mois

Comment fonctionnent les formulaires dans Nuxt

Nuxt permet d’exécuter du code sur le serveur ; la méthode native pour gérer un formulaire consiste donc à utiliser une route serveur sous server/api qui envoie un e-mail. Cela nécessite un serveur en fonctionnement ; cette fonctionnalité n’est donc pas disponible après nuxt generate, et vous devez disposer d’un fournisseur de messagerie configuré.

Avec Formgong, le formulaire est envoyé depuis le navigateur et le serveur n’intervient pas. Cela fonctionne avec le SSR, avec une sortie statique depuis nuxt generate, et sur n’importe quel hébergeur.

Mise en place dans Nuxt

  1. Créez un formulaire dans Formgong et copiez la clé d’accès.
  2. Ajoutez le composant ci-dessous à components/. Dans Nuxt, envoyez la requête avec $fetch (ou simplement fetch) dans le gestionnaire de soumission ; useFetch est destiné au chargement des données pendant le rendu de la page, et non aux clics.
  3. Placez la clé dans runtimeConfig.public si vous souhaitez l’intégrer à la configuration ; seule la configuration d’exécution publique est transmise au navigateur.
  4. Lancez « nuxt dev », envoyez un test, puis créez ou générez comme d’habitude.
Nuxt
<script setup>
import { ref } from "vue";

const status = ref("");

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();
  status.value = result.message || (result.success ? "Envoyé. Merci !" : "Échec de l’envoi. Veuillez réessayer.");
}
</script>

<template>
  <form @submit="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></textarea></label>
    <div aria-hidden="true" style="position:absolute;inset-inline-start:0;top:0;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)">
      <input name="botcheck" tabindex="-1" autocomplete="off">
    </div>
    <button type="submit">Envoyer</button>
    <p role="status">{{ status }}</p>
  </form>
</template>

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

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

Formgong ou d'une route du serveur Nuxt ?

Créez une route serveur lorsque la soumission doit accéder à vos propres données ou services.

Utilisez Formgong pour les formulaires de contact et de prospection, en particulier sur les sites générés de manière statique où aucune route de serveur n’existe.

Questions et réponses

Pourquoi $fetch et non useFetch ?

La documentation de Nuxt recommande d’utiliser useFetch pour les données nécessaires au rendu de la page et $fetch pour les requêtes déclenchées par l’utilisateur, telles que l’envoi d’un formulaire.

Est-ce que cela fonctionne avec « nuxt generate » ?

Oui. Le formulaire communique directement avec Formgong ; une version entièrement statique fonctionne donc.

Le SSR enverra-t-il le formulaire deux fois ?

Non. La requête s'exécute uniquement dans la fonction de gestion des soumissions, qui s'exécute dans le navigateur.

Commencer gratuitement