Formulario de contacto para Nuxt

Formgong team ·

Pega esto en Nuxt. 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 Nuxt

Nuxt puede ejecutar código en el servidor, así que la forma nativa de gestionar un formulario es una ruta de servidor en server/api que envía un correo electrónico. Para ello necesitas un servidor en funcionamiento, por lo que no está disponible después de nuxt generate, y tienes que tener configurado un proveedor de correo electrónico.

Con Formgong, el formulario se envía desde el navegador y el servidor no interviene. Funciona con SSR, con salida estática desde nuxt generate y en cualquier servidor.

Configuración en Nuxt

  1. Crea un formulario en Formgong y copia la clave de acceso.
  2. Añade el componente siguiente a components/. En Nuxt, envía la solicitud con $fetch (o simplemente fetch) dentro del controlador de envío; useFetch sirve para cargar datos mientras se carga la página, no para clics.
  3. Pon la clave en runtimeConfig.public si quieres incluirla en la configuración; solo la configuración pública de tiempo de ejecución llega al navegador.
  4. Ejecuta nuxt dev, envía una prueba y, a continuación, crea o genera el formulario como de costumbre.
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: "es", ...fields, access_key: "fk_your_access_key" }),
  });
  const result = await response.json();
  status.value = result.message || (result.success ? "Enviado. ¡Gracias!" : "No se pudo enviar. Inténtalo de nuevo.");
}
</script>

<template>
  <form @submit="onSubmit">
    <label>Nombre <input name="name" placeholder="Tu nombre" required></label>
    <label>Correo electrónico <input name="email" type="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%)">
      <input name="botcheck" tabindex="-1" autocomplete="off">
    </div>
    <button type="submit">Enviar</button>
    <p role="status">{{ status }}</p>
  </form>
</template>

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

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

Formgong o en una ruta del servidor Nuxt?

Escribe una ruta de servidor cuando el envío tenga que acceder a tus propios datos o servicios.

Usa Formgong para formularios de contacto y de clientes potenciales, sobre todo en sitios web generados de forma estática donde no hay rutas de servidor.

Preguntas y respuestas

¿Por qué $fetch y no useFetch?

La documentación de Nuxt recomienda useFetch para los datos necesarios mientras se carga la página y $fetch para las solicitudes que inicia el usuario, como enviar un formulario.

¿Funciona con «nuxt generate»?

Sí. El formulario se comunica directamente con Formgong, así que una versión totalmente estática funciona.

¿El SSR enviará el formulario dos veces?

No. La solicitud solo se ejecuta en el controlador de envío, que se ejecuta en el navegador.

Empezar gratis