Форма для Next.js

Formgong team ·

Вставте це в Next.js. Заявки йдуть у Formgong. Без бази і без Resend.

250 заявок безкоштовно на місяць

Як працюють форми в Next.js

В App Router рідний спосіб обробити форму — Server Action або route handler, що зазвичай викликає поштовий API із секретним ключем. Для цього потрібне серверне середовище, а Server Actions не підтримуються, якщо експортувати сайт з output: 'export'.

Клієнтському компоненту, який надсилає дані на https://formgong.com/submit, нічого з цього не потрібно. Він працює на Vercel, на будь-якому хостингу з Node і як статичний експорт, а кожна заявка приходить на пошту й у Telegram, з копією у вхідних Formgong.

Налаштування в Next.js

  1. Створіть форму у Formgong і скопіюйте ключ доступу.
  2. Додайте компонент нижче. Він починається з "use client", бо обробляє подію в браузері.
  3. Замініть ключ або читайте його зі змінної з префіксом NEXT_PUBLIC_; лише такі потрапляють у браузерний код.
  4. Додайте компонент на сторінку, запустіть next dev і надішліть тест.
  5. Хочете пакет? @formgong/react дає готовий <ContactForm>, а стартер Next.js на GitHub — це готовий проєкт.
Next.js
"use client";
import { useState } from "react";

export function ContactForm() {
  const [status, setStatus] = useState("");
  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: "uk", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Надіслано. Дякуємо!" : "Не вдалося надіслати. Спробуйте ще раз."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Ім’я <input name="name" placeholder="Ваше ім’я" required /></label>
      <label>Email <input name="email" type="email" placeholder="you@example.com" required /></label>
      <label>Повідомлення <textarea name="message" placeholder="Чим ми можемо допомогти?" required /></label>
      <div aria-hidden="true" style={{ position: "absolute", insetInlineStart: 0, top: 0, width: 1, height: 1, overflow: "hidden", clipPath: "inset(50%)" }}>
        <input name="botcheck" tabIndex={-1} autoComplete="off" />
      </div>
      <button type="submit">Надіслати</button>
      <p role="status">{status}</p>
    </form>
  );
}

Готовий стартер на GitHub: github.com/formgong/nextjs-starter. Ліцензія MIT: натисніть «Use this template» або скопіюйте файли.

Новий проєкт однією командою: npm create formgong@latest -- --template nextjs (npm: create-formgong)

Пакет із компонентом: npm install @formgong/next (npm: @formgong/next)

Додати в наявний проєкт: npx formgong init (npm: formgong)

Formgong чи Server Action?

Пишіть Server Action, коли заявка має змінювати ваші дані чи перевіряти авторизованого користувача.

Використовуйте Formgong для форм контакту, розрахунку й лідів: без поштового сервісу, секретів і боротьби зі спамом у вашому коді.

Питання та відповіді

Чи можна пропускати запит через Server Action, щоб сховати ключ?

Можна, але ховати нічого: ключ публічний. До того ж через проксі кожна заявка приходить з IP-адреси вашого сервера, а це послаблює обмеження частоти й сигнали спаму.

Чи працює це зі статичним експортом?

Так. Клієнтському компоненту, що надсилає дані у Formgong, сервер не потрібен, а Server Actions у статичному експорті не підтримуються.

Pages Router чи App Router?

Обидва. У Pages Router приберіть рядок "use client"; решта така сама.

Чи потрібні Resend або Server Action?

Ні, для контактної форми. Resend потребує підтвердженого домену і DNS-записів, а ключ API лишається на сервері. Server Action пишіть, коли заявка має змінити вашу базу або перевірити вхід користувача.

Як зупинити спам у формі Next.js?

Залиште поле botcheck порожнім. Formgong позначає заповнений honeypot як спам і не надсилає його на пошту чи в Telegram. Turnstile необов’язковий. Віджет додавайте лише після ввімкнення в налаштуваннях форми. Секрет лишається у Formgong.

Почати безкоштовно