Formulário de contacto para Vue

Formgong team ·

Cole isto no Vue. Os envios vão para o Formgong. Sem base de dados e sem Resend.

250 envios grátis por mês

Como funcionam os formulários em Vue

Uma aplicação Vue criada com o Vite é executada no navegador, pelo que um formulário de contacto necessita de um destino para onde enviar os seus dados. A solução habitual consiste em adicionar um pequeno servidor API com uma biblioteca de e-mail. O Formgong substitui esse servidor: o componente envia os dados para https://formgong.com/submit e apresenta a resposta.

O trecho abaixo é um componente de ficheiro único com <script setup>. Lê os campos com FormData, pelo que funciona com ou sem v-model e não necessita de pacotes adicionais: o fetch está integrado no navegador.

Configuração em Vue

  1. Crie um formulário no Formgong e copie a chave de acesso.
  2. Guarde o snippet como ContactForm.vue e substitua a chave. Se preferir uma variável de ambiente, utilize uma com o prefixo VITE_, tal como VITE_FORMGONG_KEY: o Vite apenas expõe essas variáveis ao código do navegador.
  3. Utilize o componente na sua página e traduza os rótulos; defina _lang para o idioma da página.
  4. Execute o servidor de desenvolvimento e envie um teste. Este aparece na caixa de entrada do Formgong e no seu e-mail.
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: "pt", ...fields, access_key: "fk_your_access_key" }),
  });
  const result = await response.json();
  status.value = result.message || (result.success ? "Enviado. Obrigado!" : "Não foi possível enviar. Tente novamente.");
}
</script>

<template>
  <form @submit="onSubmit">
    <label>Nome <input name="name" placeholder="O seu nome" required></label>
    <label>E-mail <input name="email" type="email" placeholder="voce@exemplo.com" required></label>
    <label>Mensagem <textarea name="message" placeholder="Como podemos ajudar?" 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>

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

Adicionar a um projeto existente: npx formgong init (npm: formgong)

Formgong ou no seu próprio servidor de API?

Vale a pena utilizar o seu próprio servidor quando o formulário altera dados na sua aplicação, como, por exemplo, ao criar uma encomenda.

No caso de formulários de contacto e de leads, o Formgong poupa-lhe o servidor, o fornecedor de e-mail e o tratamento de spam.

Perguntas e respostas

Preciso do Axios?

Não. A função fetch do navegador é suficiente. Se o seu projeto já utiliza o Axios, envie o mesmo corpo e cabeçalhos com ele.

Posso utilizar o v-model e bibliotecas de validação?

Sim. Mantenha a sua validação e chame fetch no manipulador de envio com os valores que recolheu.

A chave está segura numa variável VITE_?

Sim. A chave de acesso é pública de qualquer forma; a variável apenas a mantém fora do código do componente.

Começar grátis