getGT()

概要

getGT() 関数は、ビルド時に文字列を翻訳するためのサーバーサイド関数です。

const t = await getGT();
 
<p>{  t('このテキストは翻訳されます')  }</p>;

リファレンス

パラメータ

なし

戻り値

提供されたコンテンツを翻訳するコールバック関数 t() のプロミス。

Promise<(content: string, options?: InlineTranslationOptions) => string>

振る舞い

本番環境

CDプロセス中に、t() 関数内のコンテンツはアプリケーションがデプロイされる前に翻訳されます。 これにより、すべてのロケールでの読み込み時間が速くなりますが、ビルド時に既知のコンテンツのみを翻訳できます。

生成された翻訳は、設定に応じて (1) CDNに保存されるか、(2) アプリのビルド出力に保存されます。 そこから、翻訳されたコンテンツがユーザーに提供されます。 翻訳が見つからない場合は、元のコンテンツにフォールバックします。

こちらのデプロイメントガイドに従うことを確認してください。

開発環境

開発中は、t() 関数が要求に応じてコンテンツを翻訳します。 これは、アプリが異なる言語でどのように見えるかをプロトタイプするのに役立ちます。 この動作を有効にするには、環境にDev APIキーを追加することを忘れないでください。

開発中の要求に応じた翻訳では遅延が発生します。 これは、本番ビルド中には発生しませんが、コンテンツが明示的に要求に応じて翻訳されている場合、 つまり、tx() または <Tx> を使用している場合を除きます。

例

基本的な使い方

getGT() を使用して文字列を翻訳できます。

import { getGT } from 'gt-next/server';
 
export default async function TranslateGreeting() {
  const t = await getGT();
 
  return (
    <p>
      {t('Hello, Alice!')}
    </p>
  );
}

注意: "Alice" はユーザーの好みの言語に翻訳されます。

変数の使用

辞書翻訳に変数を渡すことができます。

import { getGT } from 'gt-next/server';
 
export default async function TranslateGreeting() {
  const t = await getGT();
 
  return (
    <p>
      {t('Hello, {name}!', { variables: { name: 'Alice' } })}
    </p>
  );
}

注意: "Alice" は変数であるため、ユーザーの好みの言語に翻訳されません。

メモ

• getGT() 関数は、文字列を翻訳するサーバーサイド関数です。
• getGT() を使用した翻訳は、実行時の前に、ビルドプロセス中に行われます（開発中を除く）。

次のステップ

• ビルド時にクライアント側の文字列を翻訳するには、useGT() を参照してください。
• 実行時の翻訳については、tx() および <Tx> を参照してください。
• 翻訳のカスタマイズに関する詳細は、InlineTranslationOptions を参照してください。