Formulario de contacto para Vue

Formgong team ·

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

Una aplicación Vue creada con Vite se ejecuta en el navegador, así que un formulario de contacto necesita un lugar al que enviar sus datos. Lo habitual es añadir un pequeño servidor API con una biblioteca de correo electrónico. Formgong sustituye a ese servidor: el componente envía los datos a https://formgong.com/submit y muestra la respuesta.

El fragmento de código que aparece a continuación es un componente de un solo archivo con <script setup>. Lee los campos con FormData, así que funciona tanto con como sin v-model, y no necesita paquetes adicionales: fetch ya está integrado en el navegador.

Configuración en Vue

  1. Crea un formulario en Formgong y copia la clave de acceso.
  2. Guarda el fragmento como ContactForm.vue y cambia la clave. Si prefieres una variable de entorno, usa una con el prefijo VITE_, como VITE_FORMGONG_KEY: Vite solo expone esas variables al código del navegador.
  3. Usa el componente en tu página y traduce las etiquetas; configura _lang con el idioma de la página.
  4. Ejecuta el servidor de desarrollo y envía una prueba. Aparecerá en la bandeja de entrada de Formgong y en tu correo electrónico.
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: "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 tu propio servidor API?

Merece la pena tener tu propio servidor cuando el formulario modifica datos en tu aplicación, como al crear un pedido.

Para los formularios de contacto y de clientes potenciales, Formgong te ahorra tener que gestionar el servidor, el proveedor de correo electrónico y el control del spam.

Preguntas y respuestas

¿Necesito Axios?

No. Basta con el fetch del navegador. Si tu proyecto ya usa Axios, envía el mismo cuerpo y los mismos encabezados con él.

¿Puedo usar v-model y bibliotecas de validación?

Sí. Mantén tu validación y llama a fetch en el controlador de envío con los valores que hayas recopilado.

¿Está la clave a salvo en una variable VITE_?

Sí. La clave de acceso es pública de todos modos; la variable solo sirve para mantenerla fuera del código del componente.

Empezar gratis