Formularz kontaktowy dla SvelteKit

Formgong team ·

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

250 zgłoszeń miesięcznie za darmo

Jak działają formularze w SvelteKit

Natywny sposób obsługi formularzy w SvelteKit to form action w +page.server.js, często z use:enhance. Form actions wymagają serwera: stron z akcjami nie da się prerenderować, więc nie są dostępne na stronach budowanych z adapter-static.

Formularz wysyłający dane na https://formgong.com/submit działa na każdej stronie SvelteKit, prerenderowanej lub nie. Użyj zwykłego formularza z method="POST" i adresem Formgong w action albo wyślij go przez fetch w handlerze onsubmit, żeby pokazać odpowiedź na miejscu.

Konfiguracja w SvelteKit

  1. Utwórz formularz w Formgong i skopiuj klucz dostępu.
  2. Dodaj poniższy komponent do src/lib i użyj go na stronie. Formularz z zewnętrznym action wysyła przeglądarka; SvelteKit go nie przechwytuje.
  3. Jeśli trzymasz klucz w konfiguracji, użyj zmiennej PUBLIC_ z $env/static/public; inne zmienne nigdy nie trafiają do przeglądarki.
  4. Uruchom vite dev, wyślij test, a potem zbuduj projekt ze swoim adapterem jak zwykle.
SvelteKit
<script>
  let status = $state("");

  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 = result.message || (result.success ? "Wysłano. Dziękujemy!" : "Nie udało się wysłać. Spróbuj ponownie.");
  }
</script>

<form onsubmit={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>

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

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

Formgong czy form action?

Użyj form action, gdy zgłoszenie należy do aplikacji: zapis w bazie albo sprawdzenie sesji.

Wybierz Formgong dla formularzy kontaktowych i leadów, a na stronach prerenderowanych i statycznych zawsze, bo form actions są tam niedostępne.

Pytania i odpowiedzi

Czy mogę użyć use:enhance z Formgong?

Nie. use:enhance działa z form actions SvelteKit. Dla wyniku na stronie użyj fetch w handlerze wysyłki, jak w kodzie poniżej.

Czy to działa z adapter-static?

Tak. Na Twoim serwerze nic się dla formularza nie uruchamia.

Gdzie umieścić klucz dostępu?

W komponencie albo w zmiennej środowiskowej PUBLIC_. Klucz jest z założenia publiczny.

Zacznij za darmo