JavaScriptとReact

サーバーでコンテンツを翻訳し、Reactでメッセージカタログを表示し、アプリケーションにロケールルーティングを組み込みます。

JavaScriptアプリケーションで翻訳を扱う場面は二つあります。サーバーでは、コンテンツをローカライゼーションエンジンに送信し、翻訳結果を保存します。ユーザーインターフェースでは、翻訳済みのメッセージを読み込み、適切な値、文法、書式で表示します。実装する部分に合ったパッケージを選んでください。

サーバーから翻訳する #

JavaScript APIガイドでは、標準のfetchを使った翻訳ジョブの作成から、進捗の確認、完了したファイルのダウンロードまでを説明しています。APIキーはサーバー側で管理し、各ジョブの識別情報は、翻訳対象のソースのリビジョンとひも付けて保存してください。

LingoDotDevEngineを使用するアプリケーション向けには、別途SDK v0リファレンスを用意しています。同期APIとクライアント側のバッチ処理については、引き続きそちらで説明しています。

Reactでメッセージを表示する #

Reactでは、原文のメッセージとそのコンテキストをコンポーネント内に保持します。カタログが翻訳済みのテンプレートを提供し、ランタイムが値を挿入して、アプリケーション側で制御するReact要素を生成します。表示に翻訳APIキーは必要ありません。

まずはローカルカタログを使い、一つのコンポーネントを翻訳するところから始めましょう。アプリケーションの規模が大きくなったら、カタログの抽出と読み込みに進みます。Next.js PagesとTanStack Startの実装例では、カタログをリクエスト、ルート、言語の切り替えと連携させます。独自のルーターを使う場合は、locale-routerが、その基盤となるURLと優先言語の判定を担います。

Payloadアプリケーションを接続する #

Payload CMSプラグインはフィールドスキーマを公開し、ソースコンテンツの変更をLingo.devに通知します。Payload連携では、翻訳対象のコンテンツと翻訳の書き戻し先を設定します。

サンプルプロジェクト #

これらのリポジトリでは、ソースファイルとアプリケーションの読み込み処理がどのように連携するかを確認できます。応用する前に、各プロジェクトの依存関係のバージョンと設定を確認してください。このマニュアルで扱うものとは異なる世代のパッケージを使用している場合があります。フォークしたリポジトリでは、翻訳ジョブを送信する前に、ご自身のLingo.devプロジェクトを接続してください。

プロジェクト参考になる出発点
React + Viteコンポーネントのメッセージ、抽出、カタログの読み込み。
Next.js Pagesページのメッセージとロケールに対応したルート。
TypeScriptモジュール静的にエクスポートされたロケールデータ。TypeScriptハンドラーが対応するデフォルトエクスポートの形式を使用してください。対応していないエクスポート形式では、翻訳単位が一つも生成されないことがあります。
iOSAppleのリソースとネイティブのロケール選択。
Androidリソースディレクトリと文字列の検索。
FlutterARBメタデータと生成されたメッセージ。
Markdownドキュメントのパスとフロントマター。
Markdoc + Next.js翻訳可能なタグのプロパティとドキュメントの表示。
OpenAPIAPI仕様に含まれる、人が読むための説明文。
Railsロケールをルートに置くYAMLと、フレームワークによる検索。
Laravelリソースファイルとフレームワークによる読み込み。

ネイティブリソースとドキュメントには、CLIとそれぞれに対応する形式ハンドラーを使用します。このサンプル集に含まれているからといって、Reactランタイムが必要になるわけではありません。