TypeScript

静的なデフォルトエクスポートを使うロケールモジュールで、周囲のTypeScript構文を保ちながらリテラル値を翻訳します。

TypeScriptのロケールモジュールでは、メッセージを、その型定義の近くに配置できます。typescriptファイルハンドラーは、静的なデフォルトエクスポート内のリテラル値を翻訳し、テキストをその場で置き換えます。キー、インポート、コメント、周囲の型構文はそのまま保持します。ソースを読み取る際に、モジュールを実行することはありません。

ハンドラーに静的なカタログを渡す #

インラインのオブジェクトまたは配列をデフォルトエクスポートとして使用します。

typescript
export default {
  checkout: {
    title: "Complete your order",
    retries: 3,
  },
  steps: ["Review", "Confirm"],
} as const;

文字列の翻訳単位には、checkout.title、steps[0]、steps[1]が含まれます。数値は変更されません。as const、satisfies、および対応している式を囲む丸括弧は、ソースに残しておけます。

翻訳対象の値はリテラルで記述してください。ハンドラーは、エクスポートされた識別子の宣言をたどったり、ファクトリー呼び出しを評価したりしません。計算されたプロパティキー、スプレッド、メソッド、式から生成される値は処理をスキップします。テンプレートリテラルに対応するのは、式の埋め込みがない場合に限られます。有効なモジュールから翻訳タスクが生成されない場合は、翻訳の失敗を疑う前に、デフォルトエクスポートの構造を確認してください。

確定済みの値を明示的に保持する #

以前のソースを基準に、カタログ内のパスごとに変更を判定します。変更のない文字列や、その他の理由で未解決の文字列には、既存の翻訳先にある確定済みの値を使用します。ロックされたパスでは現在のソースのリテラルを保持し、保持対象のパスでは既存の翻訳先の値があればそれを保持します。これらの制御でコードを実行し、追加のテキストを検出することはありません。

置換にはソースのリテラルと同じ引用符を使い、その引用符に合わせて翻訳内容をエスケープします。キーの更新では、選択されていない翻訳先の値を保持します。その部分的な結果に含まれないソースの項目は、配列要素も含めて削除されることがあるため、モジュールを読み込む前に、生成されたキーと配列内の要素を確認してください。

ファイルの選択を設定する #

CLIは、.ts、.mts、.ctsに対してtypescriptを推定しますが、.jsや.tsxに対しては推定しません。CLI設定またはGitHubでロケールモジュールを選択してください。

翻訳済みモジュールを読み込む #

この形式は、Reactのメッセージ抽出とは別のものです。抽出処理では、アプリケーションの.tsおよび.tsxソース内で、対応している呼び出しを読み取り、カタログを作成します。一方、このハンドラーは、すでに構造化されたロケールモジュールを翻訳します。そのライフサイクルについては、Reactのカタログと型を参照してください。

取得後はモジュールの型チェックを行い、アプリケーションのカタログローダーで読み込んでください。選択したキーを画面で使用するメッセージと照合し、プレースホルダーの動作も確認してください。これらの確認では、それぞれ異なる問題を見つけられます。無効なモジュールは読み込めず、選択されていない動的な値は未翻訳のまま残ります。また、形式上は有効な翻訳でも、意味が誤っている場合があります。