next-intl は何をしますか?
概要
next-intl は、Next.js App Router に対応した主要な i18n ライブラリです。ロケールルーティング、メッセージ翻訳、日付/数値フォーマットを処理し、サーバーコンポーネントとクライアントコンポーネントの両方で動作します。複数形や変数には ICU メッセージ構文を利用します。
手順
ステップ 1: セットアップ
npm install next-intl
// i18n/request.ts — ロケール検出
import { getRequestConfig } from 'next-intl/server'
export default getRequestConfig(async ({ requestLocale }) => {
const locale = await requestLocale || 'en'
return {
locale,
messages: (await import(`../messages/${locale}.json`)).default,
}
})
// messages/en.json
{
"HomePage": {
"title": "ようこそ {appName}",
"description": "最高のツール: {count, plural, one {# チーム} other {# チーム}}",
"cta": "はじめよう"
},
"Dashboard": {
"greeting": "こんにちは、{name} さん",
"lastLogin": "最終ログイン: {date, date, medium}"
}
}
// messages/de.json
{
"HomePage": {
"title": "Willkommen bei {appName}",
"description": "Das beste Tool für {count, plural, one {# Team} other {# Teams}}",
"cta": "Jetzt starten"
}
}
ステップ 2: サーバーコンポーネント
// app/[locale]/page.tsx — 翻訳済みサーバーコンポーネント
import { useTranslations } from 'next-intl'
export default function HomePage() {
const t = useTranslations('HomePage')
return (
<main>
<h1>{t('title', { appName: 'MyApp' })}</h1>
<p>{t('description', { count: 5000 })}</p>
<a href="/signup">{t('cta')}</a>
</main>
)
}
ステップ 3: ミドルウェアルーティング
// middleware.ts — ロケールルーティング
import createMiddleware from 'next-intl/middleware'
export default createMiddleware({
locales: ['en', 'de', 'fr', 'ja'],
defaultLocale: 'en',
localePrefix: 'as-needed', // /de/about はそのまま、/about (en) はプレフィックスなし
})
export const config = { matcher: ['/((?!api|_next|.*\..*).*)'] }
ガイドライン
- ICU メッセージ構文:
{count, plural, one {# アイテム} other {# アイテム}}で複数形に対応。 - サーバーコンポーネント:
useTranslations()を直接使用。コンテキストは不要。 - クライアントコンポーネント:
NextIntlClientProviderでラップする。 - メンテナンス性のため、メッセージキーはページ/コンポーネントごとに名前空間で管理する。
localePrefix: 'as-needed'を使うと、デフォルトロケールに /en/ プレフィックスが付かない。