Formulaire de contact pour Vue

Formgong team ·

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

250 envois gratuits par mois

Comment fonctionnent les formulaires dans Vue

Une application Vue développée avec Vite s'exécute dans le navigateur ; un formulaire de contact a donc besoin d'un destinataire vers lequel envoyer ses données. La solution habituelle consiste à ajouter un petit serveur API équipé d'une bibliothèque de gestion des e-mails. Formgong remplace ce serveur : le composant envoie ses données à https://formgong.com/submit et affiche la réponse.

L'extrait ci-dessous est un composant en un seul fichier utilisant <script setup>. Il lit les champs à l'aide de FormData, ce qui lui permet de fonctionner avec ou sans v-model, et ne nécessite aucun package supplémentaire : fetch est intégré au navigateur.

Mise en place dans Vue

  1. Créez un formulaire dans Formgong et copiez la clé d’accès.
  2. Enregistrez l’extrait de code sous le nom « ContactForm.vue » et remplacez la clé. Si vous préférez utiliser une variable d’environnement, optez pour une variable préfixée par « VITE_ », telle que « VITE_FORMGONG_KEY » : Vite n’expose ces variables qu’au code du navigateur.
  3. Utilisez le composant dans votre page et traduisez les libellés ; définissez _lang sur la langue de la page.
  4. Lancez le serveur de développement et envoyez un test. Celui-ci apparaît dans la boîte de réception Formgong et dans votre messagerie électronique.
Vue
<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 sur votre propre serveur API ?

Il est intéressant de disposer de votre propre serveur lorsque le formulaire modifie des données dans votre application, par exemple lors de la création d’une commande.

Pour les formulaires de contact et de prospection, Formgong vous évite d’avoir à gérer le serveur, le fournisseur de messagerie et le traitement des spams.

Questions et réponses

Ai-je besoin d’Axios ?

Non. L’fetche du navigateur suffit. Si votre projet utilise déjà Axios, envoyez le même corps et les mêmes en-têtes avec celui-ci.

Puis-je utiliser v-model et des bibliothèques de validation ?

Oui. Conservez vos règles de validation et appelez fetch dans la fonction de gestion de l’envoi avec les valeurs que vous avez collectées.

La clé est-elle en sécurité dans une variable VITE_ ?

Oui. La clé d’accès est de toute façon publique ; la variable sert uniquement à la dissocier du code du composant.

Commencer gratuitement