読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第2節 Server Actions でフォームを送る

2.2 "use server" で関数を作る

フォームから呼ばれる関数を、Server Actions として作ります。

// src/app/products/[id]/actions.ts
"use server";

import { redirect } from "next/navigation";
import { createReservation } from "@/lib/reservations";

export async function reserveProduct(formData: FormData) {
  const name = String(formData.get("name") ?? "");
  const productId = String(formData.get("productId") ?? "");
  const quantity = Number(formData.get("quantity"));
  const pickupAt = String(formData.get("pickupAt") ?? "");

  const reservation = await createReservation({
    name,
    pickupAt,
    items: [{ productId, quantity }],
  });

  redirect(`/reserve/done?id=${reservation.id}`);
}
// src/app/products/[id]/page.tsx の一部
import { reserveProduct } from "./actions";

<form action={reserveProduct}>
  <input type="hidden" name="productId" value={product.id} />
  <label htmlFor="name">お名前</label>
  <input id="name" name="name" required />
  <label htmlFor="quantity">個数</label>
  <input id="quantity" name="quantity" type="number" min={1} max={10} defaultValue={1} />
  <label htmlFor="pickupAt">受け取りの日時</label>
  <input id="pickupAt" name="pickupAt" type="datetime-local" required />
  <button type="submit">予約する</button>
</form>
部分意味
ファイルの先頭の "use server"このファイルの関数は、サーバーで動く Server Actions
action={reserveProduct}フォームを送ると、この関数がサーバーで呼ばれる
formData送られた入力欄の値。name 属性の名前で読む
redirect(...)処理のあと、別のページに移動する

フォームを送ると、ブラウザから Next.js のサーバーに値が送られ、reserveProduct が動きます。fetch で API を呼ぶコードや、送信用の API のファイルを書く必要はありません。JavaScript が読みこまれる前に送っても動きます。

解答の例

src/app/reserve/done/page.tsx に export default async function DonePage({ searchParams }: PageProps<"/reserve/done">) { const { id } = await searchParams; return &lt;p&gt;予約を受け付けました(予約番号 {String(id)})&lt;/p&gt;; } と書きます。searchParams の値は、文字列か文字列の配列か undefined なので、表示の前に形を確かめると、より安全です。

8 / 17