Formularz kontaktowy dla Vue

Formgong team ·

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

250 zgłoszeń miesięcznie za darmo

Jak działają formularze w Vue

Aplikacja Vue zbudowana z Vite działa w przeglądarce, więc formularz kontaktowy potrzebuje miejsca, do którego wyśle dane. Zwykle dodaje się mały serwer API z biblioteką do maili. Formgong zastępuje ten serwer: komponent wysyła dane na https://formgong.com/submit i pokazuje odpowiedź.

Poniższy kod to komponent jednoplikowy z <script setup>. Odczytuje pola przez FormData, więc działa z v-model i bez niego, i nie potrzebuje dodatkowych pakietów: fetch jest wbudowany w przeglądarkę.

Konfiguracja w Vue

  1. Utwórz formularz w Formgong i skopiuj klucz dostępu.
  2. Zapisz kod jako ContactForm.vue i podmień klucz. Jeśli wolisz zmienną środowiskową, użyj takiej z prefiksem VITE_, np. VITE_FORMGONG_KEY: tylko takie Vite udostępnia kodowi w przeglądarce.
  3. Użyj komponentu na stronie i przetłumacz etykiety; ustaw _lang na język strony.
  4. Uruchom serwer deweloperski i wyślij test. Pojawi się w skrzynce Formgong i na Twoim mailu.
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: "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 własny serwer API?

Własny serwer się opłaca, gdy formularz zmienia dane w aplikacji, np. tworzy zamówienie.

Przy formularzach kontaktowych i leadach Formgong oszczędza Ci serwer, dostawcę maili i obsługę spamu.

Pytania i odpowiedzi

Czy potrzebuję Axios?

Nie. Wystarczy fetch z przeglądarki. Jeśli projekt już używa Axios, wyślij nim tę samą treść i nagłówki.

Czy mogę używać v-model i bibliotek do walidacji?

Tak. Zostaw swoją walidację i wywołaj fetch w handlerze wysyłki z zebranymi wartościami.

Czy klucz w zmiennej VITE_ jest bezpieczny?

Tak. Klucz dostępu i tak jest publiczny; zmienna tylko trzyma go poza kodem komponentu.

Zacznij za darmo