Formulario de contacto para Astro

Formgong team ·

Pega esto en Astro. Los envíos van a Formgong. Sin base de datos y sin Resend.

250 envíos gratis al mes

Cómo funcionan los formularios en Astro

Astro crea páginas estáticas por defecto y no incluye JavaScript a menos que añadas una «island». Las Astro Actions y los puntos finales de la API se ejecutan en un servidor, por lo que necesitan un adaptador y un renderizado bajo demanda. Para un formulario de contacto en un sitio estático, eso supone mucha configuración.

Un formulario HTML sencillo en un componente .astro envía los datos a https://formgong.com/submit y no necesita nada de eso. La página se mantiene estática, el formulario funciona sin JavaScript y el visitante llega a una página de agradecimiento en su idioma o a tu propia página _redirect.

Configuración en Astro

  1. Crea un formulario en Formgong y copia la clave de acceso.
  2. Pega el fragmento de código que aparece a continuación en un componente .astro, sustituye la clave y configura _lang según el idioma de la página.
  3. Añade un campo oculto _redirect que apunte a una página de agradecimiento en tu sitio web, si tienes una.
  4. Crea el formulario como siempre; output: 'static' está bien. Publícalo y envía una prueba desde la página en producción.
  5. Opcional: envuelve el formulario en un «island» con un componente del framework si quieres que la respuesta aparezca sin salir de la página.
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="es">
  <label>Nombre <input type="text" name="name" autocomplete="name" placeholder="Tu nombre" required></label>
  <label>Correo electrónico <input type="email" name="email" autocomplete="email" placeholder="tu@ejemplo.com" required></label>
  <label>Mensaje <textarea name="message" placeholder="¿En qué podemos ayudarte?" 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>Deja este campo vacío<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label>
</div>
  
  <button type="submit">Enviar</button>
</form>

Plantilla lista en GitHub: github.com/formgong/astro-starter. Licencia MIT: pulsa «Use this template» o copia los archivos.

Proyecto nuevo con un comando: npm create formgong@latest -- --template astro (npm: create-formgong)

Paquete de componentes: npm install @formgong/astro (npm: @formgong/astro)

Añadir a un proyecto existente: npx formgong init (npm: formgong)

¿Formgong o Astro Actions?

Astro Actions son adecuadas cuando el sitio ya se ejecuta en un adaptador de servidor y el envío debe llegar a tu propio código.

En el caso de sitios web estáticos y formularios sencillos de contacto o de clientes potenciales, publicar en Formgong mantiene la estructura estática y elimina el código del servidor.

Preguntas y respuestas

¿Necesito un adaptador?

No. El formulario envía los datos a Formgong, así que basta con una versión estática.

¿Puedo ver el resultado sin salir de la página?

Sí. Usa un pequeño bloque con fetch o el script opcional de Formgong fg.js.

¿Hay algún proyecto ya listo?

Sí. El proyecto de inicio de Astro en GitHub es un sitio web operativo con este formulario, bajo la licencia MIT.

Empezar gratis