読み方のヒント

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

第2節 データ取得のライブラリを使う

2.1 useQuery で読む

TanStack Query を入れ、アプリの外側で準備をします。

npm install @tanstack/react-query
// src/components/QueryProvider.tsx
"use client";

import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { useState, type ReactNode } from "react";

export const QueryProvider = ({ children }: { children: ReactNode }) => {
  const [client] = useState(() => new QueryClient());
  return <QueryClientProvider client={client}>{children}</QueryClientProvider>;
};

管理のレイアウトを QueryProvider で包み、予約の一覧を読みます。

// src/components/TodayReservations.tsx
"use client";

import { useQuery } from "@tanstack/react-query";
import * as z from "zod";
import { ReservationSchema } from "@/lib/schemas/reservation";

const fetchTodayReservations = async () => {
  const response = await fetch("/api/admin/reservations");
  if (!response.ok) throw new Error(`読み込みに失敗しました(${response.status})`);
  return z.array(ReservationSchema).parse(await response.json());
};

export const TodayReservations = () => {
  const { data, isPending, isError, refetch } = useQuery({
    queryKey: ["reservations", "today"],
    queryFn: fetchTodayReservations,
    refetchInterval: 30_000,
  });

  if (isPending) return <p aria-busy="true">予約を読み込んでいます…</p>;
  if (isError) return <ErrorState title="予約を読み込めませんでした" onRetry={() => refetch()} />;
  if (data.length === 0) return <EmptyState title="今日の予約はまだありません" />;
  return <ReservationTable reservations={data} />;
};
部分意味
queryKeyこのデータの名前。同じ名前なら、同じ結果を使い回す
queryFnデータを読む関数
refetchInterval決まった間隔で読み直す
isPending・isError・data読み込み中・失敗・成功の状態

読み込みの関数の中で、スキーマで確かめています。形が違えば例外になり、isError になります。

6 / 16