Formulaire de contact pour Astro

Formgong team ·

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

250 envois gratuits par mois

Comment fonctionnent les formulaires dans Astro

Astro génère des pages statiques par défaut et ne fournit aucun code JavaScript, sauf si vous ajoutez une « island ». Les Astro Actions et les points de terminaison de l’API s’exécutent sur un serveur ; elles nécessitent donc un adaptateur et un rendu à la demande. Pour un formulaire de contact sur un site statique, cela représente une configuration assez lourde.

Un formulaire HTML simple intégré à un composant .astro envoie les données à https://formgong.com/submit et ne nécessite ni l’un ni l’autre. La page reste statique, le formulaire fonctionne sans JavaScript, et le visiteur est redirigé vers une page de remerciement dans sa langue ou vers votre propre page _redirect.

Mise en place dans Astro

  1. Créez un formulaire dans Formgong et copiez la clé d’accès.
  2. Collez l’extrait de code ci-dessous dans un composant « .astro », remplacez la clé et définissez « _lang » en fonction de la langue de la page.
  3. Ajoutez un champ masqué « _redirect » redirigeant vers une page de remerciement de votre site, si vous en disposez d’une.
  4. Créez comme d’habitude ; « output: 'static' » convient parfaitement. Déployez et envoyez un test depuis la page en ligne.
  5. Facultatif : placez le formulaire dans un « island » à l’aide d’un composant du framework si vous souhaitez que la réponse s’affiche sans quitter la page.
Astro
<form action="https://formgong.com/submit" method="POST">
  <input type="hidden" name="access_key" value="fk_your_access_key">
  <input type="hidden" name="_lang" value="fr">
  <label>Nom <input type="text" name="name" autocomplete="name" placeholder="Votre nom" required></label>
  <label>E-mail <input type="email" name="email" autocomplete="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%)">
  <label>Laissez ce champ vide<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label>
</div>
  
  <button type="submit">Envoyer</button>
</form>

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

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

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

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

Formgong ou Astro Actions ?

Astro Actions s’appliquent lorsque le site fonctionne déjà sur un adaptateur de serveur et que la soumission doit parvenir à votre propre code.

Pour les sites statiques et les formulaires de contact ou de prospect simples, l’utilisation de Formgong permet de conserver la structure statique du site et d’éliminer le code serveur.

Questions et réponses

Ai-je besoin d’un adaptateur ?

Non. Le formulaire envoie les données à Formgong ; une version statique suffit donc.

Puis-je afficher le résultat sans quitter la page ?

Oui. Utilisez un petit bloc avec fetch, ou le script optionnel fg.js de Formgong.

Existe-t-il un projet prêt à l'emploi ?

Oui. Le modèle Astro disponible sur GitHub est un site fonctionnel intégrant ce formulaire, sous licence MIT.

Commencer gratuitement