Hika Design logo
Home >Blog >react-i18nextを用いた言語切...
ブログトップ画像

フロントエンド

11/11/2026

react-i18nextを用いた言語切り替え機能の実装方法まとめ(React/Next.js)

6

はじめに

個人開発中のWebアプリですが、ユーザーが使いやすい言語で表示するための言語切り替え機能を実装しました。
今回は、状態管理が楽にできる(バケツリレー地獄を防げる)ライブラリとして、i18next および react-i18next を使ったので、ここでは、そのセットアップ手順と使い方を備忘録としてまとめます。
react-i18nextは、複数の言語を共通のキー値を介して簡単に切り替えられる点が、とても便利だと感じました。
全体の流れは以下の通りです。
  1. パッケージインストール
  2. 辞書データ(JSONファイル)の作成
  3. i18n設定ファイルの作成
  4. 設定ファイルのインポート
  5. 各コンポーネントで呼び出して使ってみる

1. パッケージインストール

まずはルートディレクトリにて、下記のコマンドを実行し、必要なライブラリをインストールします。
npm install i18next react-i18next

2. 辞書データ(JSONファイル)の作成

言語ごとのテキストを格納するJSONファイルを作成します。今回は、 src/locales/ ディレクトリの下に作成しました。
下記は、日本語Verと、英語VerのJSONファイルです。オブジェクトを用いてグループ単位でテキストを整理できるため、管理が非常にしやすくなります。
src/locales/ja.json
{
  "todo": {
    "title": "Todo",
    "description": "新しいToDoを入力",
    "add": "追加",
    "totalTime": "合計作業時間",
    "hourUnit": "時間",
    "minuteUnit": "分",
    "delete": "削除"
  },
  "buttons": {
	  "switchLang": "日本語"
  }
}
src/locales/en.json
{
  "todo": {
    "title": "To-Do List",
    "description": "Enter a new To-Do",
    "add": "Add",
    "totalTime": "Total Work Time",
    "hourUnit": "h",
    "minuteUnit": "m",
    "delete": "Delete"
  },
  "buttons": {
	  "switchLang": "English"
  }
}

3. i18n設定ファイルの作成

i18nextの初期化設定を行うファイル(src/i18n.ts)を作成します。ここで先ほどのJSONファイルを読み込みます。
// src/i18n.ts
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';

import ja from './locales/ja.json';
import en from './locales/en.json';

i18n
  .use(initReactI18next) // react-i18nextと連携
  .init({
    resources: {
      ja: { translation: ja },
      en: { translation: en },
    },
    lng: 'ja', // 初期言語
    fallbackLng: 'ja', // 翻訳が見つからない場合の言語
    interpolation: {
      escapeValue: false, // ReactはデフォルトでXSS対策されているためfalse
    },
  });

export default i18n;

4. 設定ファイルのインポート

アプリの最上位ファイル(Next.js App Routerであれば app/layout.tsx など)にて、ステップ3で作成した i18n.ts をインポートします。これにより、アプリ全体でi18nが有効になります。
※今回は辞書をクライアント側で読み込む簡易構成としています。
"use client";

// 辞書ライブラリー
import '@/i18n';

5. 各コンポーネントで呼び出して使ってみる

あとは任意のコンポーネントで useTranslation フックを呼び出すだけで、テキストの取得や言語の切り替えができます。なお、useTranslation フックはClient Componentでのみ使えます。
'use client';

import { useTranslation } from 'react-i18next';

const UseTranslation = () => {

	const { t, i18n } = useTranslation(); //ここでuseTranslation フックを呼び出す
	
	// 言語を切り替える関数
  const toggleLanguage = () => {
    const nextLang = i18n.language === 'en' ? 'ja' : 'en';
    i18n.changeLanguage(nextLang);
  };
	
  return (
	 <>
		 {/* 「合計作業時間」または「Total Work Time」を表示 */}
		 <p>{t('todo.totalTime')}</p> 
			  
		 {/* 言語切り替えボタン */}
		 <button onClick={toggleLanguage}>
	         {t('buttons.switchLang')}
	      </button>
   </>
   )
}

終わりに

こんな感じで実装完了です!
ブログトップ画像
当初は言語切り替えの状態管理を親コンポーネントの useState で行おうとして、いわゆる「バケツリレー地獄」になりかけていましたが、専用のライブラリを使うことで非常にスッキリと実装できました。同じように多言語対応で悩んでいる方の参考になれば幸いです!
プロフィールアイコン小

Hika

UI/UXデザインとフロントエンドを学びながら、React / Next.js / TypeScript / Supabase を使ってWebアプリを個人開発しています。

Hika Design logo
プライバシーポリシー