Pages Routerを使用しているNext.jsアプリケーションでの国際化の実装方法
Reactアプリケーションのアクセシビリティを向上させ、国際化(i18n)で新しい市場にリーチしましょう。
世界がますますグローバル化する中で、ウェブ開発者が異なる国や文化のユーザーに対応できるアプリケーションを構築することはますます重要になっています。そのための重要な手段の一つが国際化(i18n)であり、アプリケーションを異なる言語、通貨、日付フォーマットに適応させることを可能にします。
このチュートリアルでは、React Next.jsアプリケーションにサーバーサイドレンダリング付きで国際化を追加する方法を探ります。 TL;DR: 完全な例はこちらをご覧ください。
このガイドは、Pages Router を使用している Next.js アプリケーション向けです。
App Router を使用している場合は、代わりにこちらのガイドをご覧ください。
ステップ1: i18nライブラリをインストールする
Next.jsアプリケーションで国際化を実装するには、まずi18nライブラリを選びます。人気のあるライブラリには、next-intlなどがあります。しかし、この例ではTacoTranslateを使用します。
TacoTranslateは最先端のAIを使って文字列を自動的に任意の言語に翻訳し、JSONファイルの面倒な管理から解放します。
ターミナルでnpmを使ってインストールしましょう:
npm install tacotranslate
ステップ 2: 無料の TacoTranslate アカウントを作成してください
モジュールをインストールしたので、次は TacoTranslate アカウント、翻訳プロジェクト、および関連する API キーを作成する時です。こちらでアカウントを作成してください。 無料で、クレジットカードの登録は不要です。
TacoTranslateアプリケーションのUI内で、プロジェクトを作成し、そのAPIキーのタブに移動します。 read
キーを1つ、そして read/write
キーを1つ作成します。これらを環境変数として保存します。 read
キーはpublic
と呼び、read/write
キーはsecret
と呼びます。例えば、これらをプロジェクトのルートにある.env
ファイルに追加することができます。
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
クライアントサイドの本番環境に秘密の read/write
APIキーを絶対に漏らさないようにしてください。
さらに、もう2つの環境変数を追加します: TACOTRANSLATE_DEFAULT_LOCALE
と TACOTRANSLATE_ORIGIN
。
TACOTRANSLATE_DEFAULT_LOCALE
: デフォルトのフォールバックロケールコードです。この例では、英語のためにen
を設定します。TACOTRANSLATE_ORIGIN
: 文字列が保存される「フォルダ」、例えばあなたのウェブサイトのURLなどです。オリジンについてはこちらをお読みください。
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com
ステップ3: TacoTranslateの設定
TacoTranslateをアプリケーションに統合するには、先ほどのAPIキーを使ってクライアントを作成する必要があります。例えば、/tacotranslate-client.js
という名前のファイルを作成します。
const {default: createTacoTranslateClient} = require('tacotranslate');
const tacoTranslate = createTacoTranslateClient({
apiKey:
process.env.TACOTRANSLATE_SECRET_API_KEY ??
process.env.TACOTRANSLATE_PUBLIC_API_KEY ??
process.env.TACOTRANSLATE_API_KEY ??
'',
projectLocale: process.env.TACOTRANSLATE_DEFAULT_LOCALE ?? '',
});
module.exports = tacoTranslate;
まもなく自動的に TACOTRANSLATE_API_KEY
を定義します。
クライアントを別のファイルに作成することで、後で再利用しやすくなります。では、カスタムの /pages/_app.tsx
を使って、 TacoTranslate
プロバイダーを追加しましょう。
import React from 'react';
import {type AppProps} from 'next/app';
import {type Origin, type Locale, type Localizations} from 'tacotranslate';
import TacoTranslate from 'tacotranslate/react';
import TacoTranslateHead from 'tacotranslate/next/head';
import tacoTranslate from '../tacotranslate-client';
type PageProperties = {
origin: Origin;
locale: Locale;
locales: Locale[];
localizations: Localizations;
};
export default function App({Component, pageProps}: AppProps<PageProperties>) {
const {origin, locale, locales, localizations} = pageProps;
return (
<TacoTranslate
client={tacoTranslate}
origin={origin}
locale={locale}
localizations={localizations}
>
<TacoTranslateHead rootUrl="https://your-website.com" locales={locales} />
<Component {...pageProps} />
</TacoTranslate>
);
}
すでにカスタムの pageProps
と _app.tsx
をお持ちの場合は、上記のプロパティとコードを定義に追加してください。
ステップ 4: サーバーサイドレンダリングの実装
TacoTranslateは翻訳のサーバーサイドレンダリングを可能にします。これにより、最初に未翻訳のコンテンツが一瞬表示されることなく、翻訳済みのコンテンツを即座に表示することでユーザー体験が大幅に向上します。さらに、必要な翻訳はすでに揃っているため、クライアント側でのネットワークリクエストを省略できます。
まず、/next.config.js
を作成するか、修正することから始めます。
const withTacoTranslate = require('tacotranslate/next/config').default;
const tacoTranslateClient = require('./tacotranslate-client');
module.exports = async () => {
const config = {};
return withTacoTranslate(config, {
client: tacoTranslateClient,
isProduction:
process.env.TACOTRANSLATE_ENV === 'production' ||
process.env.VERCEL_ENV === 'production' ||
(!(process.env.TACOTRANSLATE_ENV || process.env.VERCEL_ENV) &&
process.env.NODE_ENV === 'production'),
});
};
isProduction
のチェックをあなたの環境に合わせて修正してください。もし true
なら、TacoTranslate は公開の API キーを使用します。ローカル、テスト、またはステージング環境(isProduction
is false
) では、新しい文字列が翻訳に送信されるように秘密の read/write
API キーを使用します。
これまで、Next.jsアプリケーションに対応する言語のリストを設定しただけでした。次に行うのは、すべてのページの翻訳を取得することです。そのためには、要件に応じて getTacoTranslateStaticProps
または getTacoTranslateServerSideProps
を使用します。
これらの関数は3つの引数を取ります:1つは Next.js Static Props Context オブジェクト、もう1つは TacoTranslate の設定、そしてオプションの Next.js プロパティです。なお、getTacoTranslateStaticProps
の revalidate
はデフォルトで60に設定されており、これにより翻訳が最新の状態に保たれます。
これらの関数をページで使用するには、例えば /pages/hello-world.tsx
のようなページファイルがあると仮定します。
import {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';
export async function getStaticProps(context) {
return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}
export default function Page() {
return <Translate string="Hello, world!"/>;
}
これで、すべてのReactコンポーネント内で文字列を翻訳するためにTranslate
コンポーネントを使用できるようになりました。
import {Translate} from 'tacotranslate/react';
function Component() {
return <Translate string="Hello, world!"/>
}
ステップ 5: デプロイしてテスト!
これで完了です! Translate
コンポーネントに文字列を追加すると、あなたの React アプリケーションは自動的に翻訳されるようになります。APIキーに read/write
権限がある環境のみ、新しい翻訳用の文字列を作成できます。公開前に新しい文字列を追加して本番アプリケーションをテストできるよう、閉鎖的で安全なステージング環境を用意することをお勧めします。これにより、秘密のAPIキーが盗まれるのを防ぎ、新しい無関係な文字列の追加によって翻訳プロジェクトが膨らむのを防止できます。
必ずGitHubのプロファイルにある完全な例を確認してください。そこで、App Routerを使った方法の例も見つけることができます。もし問題が発生した場合は、遠慮なくお問い合わせください。喜んでお手伝いします。
TacoTranslateは、あなたのReactアプリケーションを75以上の言語間で自動的に高速にローカライズします。今すぐ始めましょう!