翻訳したメッセージを初めて表示する

ローカルカタログでスペイン語の挨拶を表示し、名前の置換と原文へのフォールバックを確認します。

英語の原文メッセージから オラ、アナ。 と表示してみましょう。この例ではスペイン語の翻訳をあらかじめ用意しているため、コンポーネント、カタログ、プロバイダーの連携を具体的に確認できます。Lingo.dev のアカウントや API キーは不要です。

React 19 アプリケーションにインストールする #

sh
npm install @lingo.dev/react@1.17.1

この手順では、既存の React 19 アプリケーションを使います。パッケージは React 18 と 19 をピア依存関係として宣言していますが、プロバイダーには React 19 のコンテキストプロバイダーの省略記法を使っています。React 18 のプロジェクトにインストールできても、そこで描画できることが確認されたわけではありません。

挨拶とカタログを追加する #

このコンポーネントを src/App.tsx に配置し、アプリケーションの既存のエントリーポイントから描画します。

tsx
import { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";

const messages = {
  [computeKey("Hello, {name}.", "Greeting on the account dashboard")]:
    "Hola, {name}.",
};

function Greeting() {
  const l = useLingo();
  return (
    <h1>
      {l.text("Hello, {name}.", {
        context: "Greeting on the account dashboard",
        values: { name: "Ana" },
      })}
    </h1>
  );
}

export default function App() {
  return (
    <LingoProvider locale="es" messages={messages}>
      <Greeting />
    </LingoProvider>
  );
}

アプリケーションの開発用コマンドを実行し、ページを開きます。見出しに オラ、アナ。 と表示されます。実行時には、原文とコンテキストから同じキーが算出され、スペイン語のテンプレートが取得されて、{name} が Ana に置き換えられます。

カタログには文全体が格納されているため、翻訳時に語順を変えられます。名前は値として扱われ、キーには含まれません。別の名前でも同じカタログエントリが使われます。後で抽出ツールが検出できるよう、l.text の呼び出しでは原文とコンテキストをリテラルのまま記述してください。

翻訳がない場合の動作を確認する #

一時的に、プロバイダーに messages={{}} を渡します。見出しが ハロー、アナ。 に変わります。原文がフォールバック用のテンプレートとして使われ、値の置換も引き続き行われます。エントリの値が "" の場合も、原文が選ばれます。

messages を元に戻し、呼び出しのコンテキストだけを "Greeting on the profile page" に変更します。別のメッセージとして識別されるため、元の翻訳とは一致しなくなります。コンテキストを元に戻すと、再び オラ、アナ。 と表示されます。この確認によって、カタログがない場合と、要求されたメッセージが翻訳済みのメッセージと一致しない場合を区別できます。

ローカルのマップを抽出したカタログに置き換える #

これで、このコンポーネントからメッセージを抽出する準備が整いました。カタログの抽出と読み込みでは、locales/en.jsonc を生成し、CLI の設定で選択して、スペイン語の翻訳を取得し、安全に読み込む方法を説明しています。次は、この一連の作業に進みましょう。上記のローカルの例は、引き続き描画テストに活用できます。

ルーティングを使うアプリケーションでは、Next.js Pages または TanStack Start に進んでください。ロケールを切り替える際は、新しいロケールとそのメッセージを一緒に切り替える必要があります。これにより、画面上で、ある言語のテキストと別の言語の書式が混在するのを防げます。