ログイン画面とログイン処理
API側の準備ができたので、ここからフロントエンド側の実装に入ります。ログイン画面を作り、フォームの送信・成功時のダッシュボードへのリダイレクト・失敗時のエラー表示までを1つのコンポーネントにまとめます。
1. ログイン画面の実装
フォームは入力状態の管理・送信中フラグ・エラー表示などクライアント側の状態を持つため、Client Component として実装します。
1.1 ログインページの作成
エクスプローラーで app フォルダを右クリックして「新しいフォルダー」で login を作り、その中に page.tsx を作ります。
frontend-login-demo/
├── app/
│ ├── api/
│ ├── lib/
│ ├── login/ ← このフォルダを作成
│ │ └── page.tsx ← このファイルを作成
│ └── ...
└── ...
作成した app/login/page.tsx に以下の内容を記述して保存します。
"use client";
import { useState } from "react";
import { useRouter } from "next/navigation";
export default function LoginPage() {
const router = useRouter();
const [email, setEmail] = useState("alice@example.com");
const [password, setPassword] = useState("password123");
const [error, setError] = useState<string | null>(null);
const [submitting, setSubmitting] = useState(false);
const handleSubmit = async (event: React.FormEvent) => {
event.preventDefault();
setSubmitting(true);
setError(null);
const res = await fetch("/api/login", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ email, password }),
});
if (!res.ok) {
const data = await res.json();
setError(data.error ?? "ログインに失敗しました");
setSubmitting(false);
return;
}
router.push("/dashboard");
};
return (
<main className="mx-auto max-w-md p-8">
<h1 className="text-2xl font-bold mb-6">ログイン</h1>
<form onSubmit={handleSubmit} className="space-y-4">
<div>
<label className="block text-sm mb-1">メールアドレス</label>
<input
type="email"
value={email}
onChange={(e) => setEmail(e.target.value)}
className="w-full border rounded px-3 py-2"
required
/>
</div>
<div>
<label className="block text-sm mb-1">パスワード</label>
<input
type="password"
value={password}
onChange={(e) => setPassword(e.target.value)}
className="w-full border rounded px-3 py-2"
required
/>
</div>
{error && <p className="text-red-600 text-sm">{error}</p>}
<button
type="submit"
disabled={submitting}
className="w-full bg-black text-white rounded py-2 disabled:opacity-50"
>
{submitting ? "ログイン中..." : "ログイン"}
</button>
</form>
</main>
);
}
1.2 コードの解説
コードを解説します。
"use client";
このファイルをClient Componentとして扱う宣言です。フォームの入力状態やクリックイベントを扱うためには、ブラウザ側で実行されるコンポーネントである必要があります。
const [email, setEmail] = useState("alice@example.com");
const [password, setPassword] = useState("password123");
const [error, setError] = useState<string | null>(null);
const [submitting, setSubmitting] = useState(false);
フォームの入力値・エラーメッセージ・送信中フラグを、Reactの状態として管理します。email と password の初期値には、認証APIでハードコードした alice@example.com / password123 を入れてあり、フォームを開いてすぐに「ログイン」ボタンを押せば動作確認できるようにしてあります。submitting は連打防止と送信中の表示切り替えに使います。
const res = await fetch("/api/login", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ email, password }),
});
作成した認証APIに、入力されたメールアドレス・パスワードをPOSTします。Next.jsのRoute Handlerと同じオリジン(localhost:3000)へのリクエストのため、レスポンスの Set-Cookie は自動的にブラウザに保存されます。
if (!res.ok) {
const data = await res.json();
setError(data.error ?? "ログインに失敗しました");
setSubmitting(false);
return;
}
router.push("/dashboard");
res.ok が false(401)なら、APIから返ってきたエラーメッセージを画面に表示します。成功時は useRouter().push("/dashboard") でダッシュボード画面に遷移します。
1.3 動作確認
ログイン画面と認証APIが連携して動くことを、ここで確認します。開発サーバを npm run dev で起動したまま、ブラウザで http://localhost:3000/login を開きます。
「ログイン」の見出し・メールアドレス欄・パスワード欄・「ログイン」ボタンからなる、以下のようなフォームが表示されれば、ログイン画面のレンダリングは動いています。

初期値のまま(alice@example.com / password123)で「ログイン」ボタンを押します。/dashboard に遷移し、以下のように「404」と「This page could not be found.」が表示されれば、フォーム送信 → 認証APIへのPOST → 成功時のリダイレクトまでが動いています。/dashboard はまだ作っていないので、この時点で404になるのが正しい挙動です。

続けて、Cookieがブラウザに正しく保存されているかを確認します。ブラウザのDevTools(macOSは Cmd + Option + I、Windowsは F12)を開き、上部タブから「Application」を選択します。左のサイドバーの「Storage」セクションから「Cookies」→「http://localhost:3000」をクリックし、以下のように token という名前のCookieが表示されていて HttpOnly 列(列幅が狭い場合は Ht... と省略表示されます)にチェックが入っていれば、認証APIから発行されたCookieがブラウザ側でも正しく受け取れています。

最後に、失敗時のエラー表示を確認します。ブラウザで http://localhost:3000/login に戻り、パスワードを wrongpass などの誤った値に書き換えて「ログイン」ボタンを押します。以下のようにフォームの下に赤字で「メールアドレスまたはパスワードが正しくありません」と表示されれば、エラーハンドリングも動いています。

| ⚠️ ブラウザ拡張機能に起因するエラーが出た場合 |
|---|
| 動作確認中に、以下のようなエラーがブラウザの開発者コンソールに表示されることがあります。 - A tree hydrated but some attributes of the server rendered HTML didn't match the client properties. (差分に data-google-analytics-opt-out や data-redeviation-bs-uid など、見覚えのない属性が含まれるハイドレーションエラー)- Uncaught TypeError: Failed to execute 'measure' on 'Performance': 'ページ名' cannot have a negative time stamp. (Next.jsのパフォーマンス計測APIに拡張機能の処理タイミングが干渉して起きるエラー)いずれも、ブラウザ拡張機能が <html> 要素に独自の属性を差し込んだり、Next.jsの内部処理に割り込んだりすることが原因で、ハンズオンで書いたコード側の問題ではありません。回避するには、シークレットウィンドウ(macOSは Cmd + Shift + N、Windowsは Ctrl + Shift + N)で http://localhost:3000 を開くと、拡張機能が読み込まれない状態で動作確認できます。 |