Formularz kontaktowy dla Nuxt

Formgong team ·

Wklej to do Nuxt. Zgłoszenia idą do Formgong. Bez bazy i bez Resend.

250 zgłoszeń miesięcznie za darmo

Jak działają formularze w Nuxt

Nuxt potrafi uruchamiać kod na serwerze, więc natywny sposób obsługi formularza to trasa serwera w server/api, która wysyła maila. To wymaga działającego serwera, więc po nuxt generate nie jest dostępne, a dostawcę maili trzeba mieć skonfigurowanego.

Z Formgong formularz wysyła dane z przeglądarki i serwer nie bierze w tym udziału. Działa z SSR, ze statycznym wynikiem nuxt generate i na każdym hostingu.

Konfiguracja w Nuxt

  1. Utwórz formularz w Formgong i skopiuj klucz dostępu.
  2. Dodaj poniższy komponent do components/. W Nuxt wysyłaj żądanie przez $fetch (albo zwykły fetch) w handlerze wysyłki; useFetch służy do ładowania danych podczas renderowania strony, a nie do kliknięć.
  3. Jeśli chcesz trzymać klucz w konfiguracji, umieść go w runtimeConfig.public; do przeglądarki trafia tylko publiczna konfiguracja.
  4. Uruchom nuxt dev, wyślij test, a potem zbuduj lub wygeneruj stronę jak zwykle.
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: "pl", ...fields, access_key: "fk_your_access_key" }),
  });
  const result = await response.json();
  status.value = result.message || (result.success ? "Wysłano. Dziękujemy!" : "Nie udało się wysłać. Spróbuj ponownie.");
}
</script>

<template>
  <form @submit="onSubmit">
    <label>Imię <input name="name" placeholder="Twoje imię" required></label>
    <label>E-mail <input name="email" type="email" placeholder="ty@example.com" required></label>
    <label>Wiadomość <textarea name="message" placeholder="W czym możemy pomóc?" 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">Wyślij</button>
    <p role="status">{{ status }}</p>
  </form>
</template>

Pakiet z komponentem: npm install @formgong/vue (npm: @formgong/vue)

Dodaj do istniejącego projektu: npx formgong init (npm: formgong)

Formgong czy trasa serwera Nuxt?

Napisz trasę serwera, gdy zgłoszenie ma dotknąć Twoich danych albo usług.

Wybierz Formgong dla formularzy kontaktowych i leadów, zwłaszcza na stronach generowanych statycznie, gdzie trasy serwera nie ma.

Pytania i odpowiedzi

Dlaczego $fetch, a nie useFetch?

Dokumentacja Nuxt zaleca useFetch dla danych potrzebnych podczas renderowania strony, a $fetch dla żądań wywoływanych przez użytkownika, takich jak wysłanie formularza.

Czy to działa z nuxt generate?

Tak. Formularz komunikuje się bezpośrednio z Formgong, więc w pełni statyczny build działa.

Czy SSR wyśle formularz dwa razy?

Nie. Żądanie uruchamia się tylko w handlerze wysyłki, który działa w przeglądarce.

Zacznij za darmo