Formulaire de contact pour SvelteKit

Formgong team ·

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

250 envois gratuits par mois

Comment fonctionnent les formulaires dans SvelteKit

La méthode native de SvelteKit pour gérer les formulaires consiste en une action de formulaire dans +page.server.js, souvent associée à use:enhance. Les actions de formulaire nécessitent un serveur : les pages comportant des actions ne peuvent pas être pré-renduées ; elles ne sont donc pas disponibles sur les sites créés avec adapter-static.

Un formulaire qui envoie ses données à https://formgong.com/submit fonctionne sur n’importe quelle page SvelteKit, qu’elle soit pré-renduée ou non. Utilisez un formulaire simple avec method="POST" et l’URL Formgong sous la forme action, ou envoyez-le avec fetch dans un gestionnaire onsubmit pour afficher la réponse directement sur la page.

Mise en place dans SvelteKit

  1. Créez un formulaire dans Formgong et copiez la clé d’accès.
  2. Ajoutez le composant ci-dessous à src/lib et utilisez-le dans votre page. Un formulaire dont l’action est externe est envoyé par le navigateur ; SvelteKit ne l’intercepte pas.
  3. Si vous conservez la clé dans la configuration, utilisez une variable « PUBLIC_ » provenant de $env/static/public ; les autres variables ne parviennent jamais au navigateur.
  4. Exécutez vite dev, envoyez un test, puis procédez à la création avec votre adaptateur comme d’habitude.
SvelteKit
<script>
  let status = $state("");

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

<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></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>

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

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

Formgong ou d’une action du formulaire ?

Utilisez une action de formulaire lorsque la soumission concerne votre application : enregistrez-la dans votre base de données ou vérifiez la session.

Utilisez Formgong pour les formulaires de contact et de prospection, et toujours sur des sites pré-rendu ou statiques, où les actions de formulaire ne sont pas disponibles.

Questions et réponses

Puis-je utiliser use:enhance avec Formgong ?

Non. use:enhance fonctionne avec les actions de formulaire SvelteKit. Pour obtenir un résultat directement sur la page, utilisez fetch dans la fonction de gestion de l’envoi, comme dans l’extrait de code.

Est-ce que cela fonctionne avec « adapter-static » ?

Oui. Aucun processus lié au formulaire ne s'exécute sur votre serveur.

Où dois-je placer la clé d'accès ?

Dans le composant ou dans une variable d’environnement « PUBLIC_ ». La clé est publique par défaut.

Commencer gratuitement