Intlayerの今後のリリースに関する通知を受け取る
    作成:2024-08-11最終更新:2025-06-29

    ドキュメント: intlayergetTranslationContent 関数

    説明

    getTranslationContent 関数は、カスタマイズ可能な言語コンテンツのセットから特定のロケールに対応するコンテンツを取得します。指定されたロケールが見つからない場合は、プロジェクトで設定されたデフォルトのロケールのコンテンツを返します。

    パラメーター

    • languageContent: CustomizableLanguageContent<Content>

      • 説明: 複数のロケールの翻訳を含むオブジェクトです。各キーはロケールを表し、その値が対応するコンテンツです。
      • : CustomizableLanguageContent<Content>
        • Content は任意の型で、デフォルトは string です。
    • locale: Locales

      • 説明: コンテンツを取得する対象のロケールです。
      • : Locales

    戻り値

    • : Content
    • 説明: 指定されたロケールに対応するコンテンツです。ロケールが見つからない場合は、デフォルトのロケールのコンテンツが返されます。

    使用例

    基本的な使用例

    typescript
    import { getTranslationContent, Locales } from "intlayer";const content = getTranslationContent(  {    en: "Hello",    fr: "Bonjour",  },  Locales.ENGLISH);console.log(content); // 出力: "Bonjour"

    ロケールが見つからない場合:

    typescript
    import { getTranslationContent, Locales } from "intlayer";const content = getTranslationContent(  {    en: "Hello",    fr: "Bonjour",  },  Locales.SPANISH);console.log(content); // 出力: "Hello" (デフォルトロケールの内容)

    カスタムコンテンツタイプの使用:

    typescript
    import { getTranslationContent, Locales } from "intlayer";const customContent = getTranslationContent<Record<string, string>>(  {    en: { greeting: "Hello" },    fr: { greeting: "Bonjour" },  },  Locales.FRENCH);console.log(customContent.greeting); // 出力: "Bonjour"

    エッジケース

    • ロケールが見つからない場合:
      • localelanguageContent に見つからない場合、関数はデフォルトのロケールのコンテンツを返します。
    • 不完全な言語コンテンツ:
      • ロケールが部分的に定義されている場合、関数はコンテンツをマージしません。指定されたロケールの値を厳密に取得するか、デフォルトにフォールバックします。
    • TypeScriptの強制:
      • languageContent内のロケールがプロジェクトの設定と一致しない場合、TypeScriptはすべての必須ロケールが定義されていることを強制し、コンテンツが完全かつ型安全であることを保証します。

    ドキュメント履歴

    • 5.5.10 - 2025-06-29: 履歴の初期化
    Intlayerの今後のリリースに関する通知を受け取る