読み方のヒント

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

第3節 URL を状態に使う

3.1 searchParams で読む

商品一覧のページで、URL の category を読みます。

// src/app/products/page.tsx
import { Suspense } from "react";
import * as z from "zod";
import { getProducts } from "@/lib/products";
import { PRODUCT_CATEGORIES } from "@/types/product";

const FilterSchema = z.object({
  category: z.enum(PRODUCT_CATEGORIES).optional().catch(undefined),
});

const ProductResults = async ({ searchParams }: Pick<PageProps<"/products">, "searchParams">) => {
  const { category } = FilterSchema.parse(await searchParams);
  const products = await getProducts();
  const visible = category === undefined ? products : products.filter((p) => p.category === category);
  return <ProductList products={visible} />;
};

export default function ProductsPage({ searchParams }: PageProps<"/products">) {
  return (
    <main>
      <h1>商品一覧</h1>
      <CategoryLinks />
      <Suspense fallback={<p>商品を読み込んでいます…</p>}>
        <ProductResults searchParams={searchParams} />
      </Suspense>
    </main>
  );
}

/products?category=pastry を開くと、菓子パンだけが表示されます。この URL を送れば、受け取った人にも同じ一覧が表示されます。

URL の値は、誰でも書きかえられる外から来るデータです。?category=cake のような値が来ることもあるので、スキーマで確かめます。.catch(undefined) は、合わない値のときに「絞り込みなし」として扱う書き方です。

URLcategory表示
/productsundefinedすべて
/products?category=pastry"pastry"菓子パンだけ
/products?category=cakeundefined(合わない値)すべて

10 / 16