国際化 (Internationalization)

Next.jsでは、複数言語をサポートするためのルーティングとコンテンツのレンダリングを設定できます。サイトを異なるロケールに対応させるには、翻訳されたコンテンツ（ローカライゼーション）と国際化されたルートが必要です。

用語解説

ロケール (Locale): 言語と書式設定の優先順位を識別するための識別子。通常、ユーザーの優先言語と地理的な地域が含まれます。
- en-US: アメリカで話される英語
- nl-NL: オランダで話されるオランダ語
- nl: 特定の地域を指定しないオランダ語

ルーティングの概要

ブラウザの言語設定を使用して、どのロケールを使用するかを選択することを推奨します。優先言語を変更すると、アプリケーションへのリクエストのAccept-Languageヘッダーが変更されます。

例えば、以下のライブラリを使用すると、受信したRequestを基に、Headers、サポート予定のロケール、デフォルトロケールを考慮して使用するロケールを決定できます。

middleware.js

import { match } from '@formatjs/intl-localematcher'
import Negotiator from 'negotiator'

let headers = { 'accept-language': 'en-US,en;q=0.5' }
let languages = new Negotiator({ headers }).languages()
let locales = ['en-US', 'nl-NL', 'nl']
let defaultLocale = 'en-US'

match(languages, locales, defaultLocale) // -> 'en-US'

ルーティングは、サブパス（/fr/products）またはドメイン（my-site.fr/products）によって国際化できます。この情報を使用して、Middleware内でロケールに基づいてユーザーをリダイレクトできます。

middleware.js

import { NextResponse } from "next/server";

let locales = ['en-US', 'nl-NL', 'nl']

// 上記と同様の方法またはライブラリを使用して優先ロケールを取得
function getLocale(request) { ... }

export function middleware(request) {
  // パス名にサポートされているロケールがあるか確認
  const { pathname } = request.nextUrl
  const pathnameHasLocale = locales.some(
    (locale) => pathname.startsWith(`/${locale}/`) || pathname === `/${locale}`
  )

  if (pathnameHasLocale) return

  // ロケールがない場合はリダイレクト
  const locale = getLocale(request)
  request.nextUrl.pathname = `/${locale}${pathname}`
  // 例: 受信リクエストが/productsの場合
  // 新しいURLは/en-US/productsになる
  return NextResponse.redirect(request.nextUrl)
}

export const config = {
  matcher: [
    // 内部パス(_next)をスキップ
    '/((?!_next).*)',
    // オプション: ルート(/)URLのみで実行
    // '/'
  ],
}

最後に、app/内のすべての特別なファイルがapp/[lang]の下にネストされていることを確認してください。これにより、Next.jsルーターがルート内の異なるロケールを動的に処理し、langパラメータをすべてのレイアウトとページに転送できます。例えば：

// 現在のロケールにアクセス可能
// 例: /en-US/products -> `lang`は"en-US"
export default async function Page({
  params,
}: {
  params: Promise<{ lang: string }>
}) {
  const { lang } = await params
  return ...
}

ルートレイアウトも新しいフォルダ（例: app/[lang]/layout.js）にネストできます。

ローカライゼーション

ユーザーの優先ロケールに基づいて表示コンテンツを変更するローカライゼーションは、Next.jsに固有のものではありません。以下に説明するパターンは、どのウェブアプリケーションでも同じように機能します。

アプリケーション内で英語とオランダ語のコンテンツをサポートしたいと仮定しましょう。2つの異なる「辞書」を維持する場合があります。これは、キーからローカライズされた文字列へのマッピングを提供するオブジェクトです。例えば：

dictionaries/en.json

{
  "products": {
    "cart": "Add to Cart"
  }
}

dictionaries/nl.json

{
  "products": {
    "cart": "Toevoegen aan Winkelwagen"
  }
}

次に、要求されたロケールの翻訳を読み込むgetDictionary関数を作成できます：

import 'server-only'

const dictionaries = {
  en: () => import('./dictionaries/en.json').then((module) => module.default),
  nl: () => import('./dictionaries/nl.json').then((module) => module.default),
}

export const getDictionary = async (locale: 'en' | 'nl') =>
  dictionaries[locale]()

現在選択されている言語を基に、レイアウトまたはページ内で辞書を取得できます。

import { getDictionary } from './dictionaries'

export default async function Page({
  params,
}: {
  params: Promise<{ lang: 'en' | 'nl' }>
}) {
  const { lang } = await params
  const dict = await getDictionary(lang) // en
  return <button>{dict.products.cart}</button> // Add to Cart
}

app/ディレクトリ内のすべてのレイアウトとページはデフォルトでサーバーコンポーネントであるため、翻訳ファイルのサイズがクライアント側のJavaScriptバンドルサイズに影響を与えることを心配する必要はありません。このコードはサーバー上でのみ実行され、結果のHTMLのみがブラウザに送信されます。

静的レンダリング

特定のロケールセットに対して静的ルートを生成するには、任意のページまたはレイアウトでgenerateStaticParamsを使用できます。これはルートレイアウトなどでグローバルに設定できます：

export async function generateStaticParams() {
  return [{ lang: 'en-US' }, { lang: 'de' }]
}

export default async function RootLayout({
  children,
  params,
}: Readonly<{
  children: React.ReactNode
  params: Promise<{ lang: 'en-US' | 'de' }>
}>) {
  return (
    <html lang={(await params).lang}>
      <body>{children}</body>
    </html>
  )
}

用語解説

ルーティングの概要

ローカライゼーション

静的レンダリング

リソース

On this page