Formulário de contacto para Astro

Formgong team ·

Cole isto no Astro. 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 Astro

O Astro cria páginas estáticas por predefinição e não inclui JavaScript, a menos que adicione uma «island». As Astro Actions e os pontos de extremidade da API são executados num servidor, pelo que necessitam de um adaptador e de renderização a pedido. Para um formulário de contacto num site estático, isso representa uma configuração bastante complexa.

Um formulário HTML simples num componente .astro envia os dados para https://formgong.com/submit e não necessita de nenhum dos dois. A página permanece estática, o formulário funciona sem JavaScript e o visitante é redirecionado para uma página de agradecimento no seu idioma ou para a sua própria página _redirect.

Configuração em Astro

  1. Crie um formulário no Formgong e copie a chave de acesso.
  2. Cole o trecho abaixo num componente .astro, substitua a chave e defina _lang de acordo com o idioma da página.
  3. Adicione um campo oculto _redirect que aponte para uma página de agradecimento no seu site, caso tenha uma.
  4. Crie como habitualmente; output: 'static' está correto. Implemente e envie um teste a partir da página ativa.
  5. Opcional: coloque o formulário num bloco isolado com um componente do framework, caso pretenda que a resposta apareça sem sair da 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="pt">
  <label>Nome <input type="text" name="name" autocomplete="name" placeholder="O seu nome" required></label>
  <label>E-mail <input type="email" name="email" autocomplete="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%)">
  <label>Deixe este campo vazio<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label>
</div>
  
  <button type="submit">Enviar</button>
</form>

Starter pronto no GitHub: github.com/formgong/astro-starter. Licença MIT: clique em “Use this template” ou copie os arquivos.

Projeto novo com um comando: npm create formgong@latest -- --template astro (npm: create-formgong)

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

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

Formgong ou Astro Actions?

Astro Actions são adequadas quando o site já funciona num adaptador de servidor e o envio tem de chegar ao seu próprio código.

No caso de sites estáticos e de formulários simples de contacto ou de leads, o envio para o Formgong mantém a estrutura estática e elimina o código do servidor.

Perguntas e respostas

Preciso de um adaptador?

Não. O formulário envia os dados para o Formgong, pelo que basta uma compilação estática.

É possível ver o resultado sem sair da página?

Sim. Utilize um pequeno bloco com fetch ou o script opcional fg.js do Formgong.

Existe algum projeto já pronto?

Sim. O modelo inicial do Astro no GitHub é um site funcional com este formulário, ao abrigo da licença MIT.

Começar grátis