国際化 (i18n)
優先度: P2 (中)
ロケールの単一情報源を維持し、SEO に優れたサブパスルーティングを保証します。
実装ガイドライン
- ロケールルーティング: SEO のために URL ファーストのアプローチ に従ってください。App Router では 動的セグメント (例:
app/[lang]/page.tsx) を、Pages Router ではnext.config.jsのi18n設定を使用します。 - ライブラリの選択: 最新の App Router には
next-intlを、レガシーアプリにはreact-intl/next-translateを使用します。 - 検出: ミドルウェアによるローカライゼーション (
middleware.ts内) を実装し、Accept-Languageヘッダーまたは Cookie からユーザーの言語を検出してリダイレクトを実行します。 - サーバーサイド: クライアントバンドルを小さく保つために、Server Components で翻訳
messages/*.json辞書を読み込みます。getMessages()またはrequestConfigパターンを使用します。 - SEO: すべての翻訳済みルートに対して、
metadataAPI でhreflangタグが正しく生成されるようにします。 - 静的生成:
generateStaticParamsを使用して、ビルド時に静的なページのローカライズ版を事前レンダリングします。module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. ライブラリ固有の設定
一般的なライブラリの詳細なセットアップについては、以下を参照してください。
アンチパターン
- JSX にハードコードされた文字列は使用しない: 翻訳キーを使用し、生のテキストをコミットしないでください。
- クライアントサイドの翻訳バンドルは使用しない:
getMessages()を使用してサーバーサイドで辞書を読み込みます。 - URL ロケールパターンを混在させない: サブパスまたはドメインのいずれかを一貫して使用します。