Dokumentacja: funkcja getTranslationContent w intlayer

Opis

Funkcja getTranslationContent pobiera zawartość odpowiadającą określonemu locale z zestawu konfigurowalnych treści językowych. Jeśli podany locale nie zostanie znaleziony, domyślnie zwraca zawartość dla domyślnego locale skonfigurowanego w projekcie.

Parametry

• languageContent: CustomizableLanguageContent<Content>

  • Opis: Obiekt zawierający tłumaczenia dla różnych locale. Każdy klucz reprezentuje locale, a jego wartość to odpowiadająca zawartość.
  • Typ: CustomizableLanguageContent<Content>
    • Content może być dowolnym typem, domyślnie string.

• locale: Locales

  • Opis: Locale, dla którego ma zostać pobrana zawartość.
  • Typ: Locales

Zwraca

• Typ: Content
• Opis: Zawartość odpowiadająca określonemu locale. Jeśli locale nie zostanie znalezione, zwracana jest zawartość domyślnego locale.

Przykład użycia

Podstawowe użycie

import { getTranslationContent, Locales } from "intlayer";

const content = getTranslationContent(
  {
    en: "Hello",
    fr: "Bonjour",
  },
  Locales.ENGLISH
);

console.log(content); // Wynik: "Bonjour"

Brak locale:

import { getTranslationContent, Locales } from "intlayer";

const content = getTranslationContent(
  {
    en: "Hello",
    fr: "Bonjour",
  },
  Locales.SPANISH
);

console.log(content); // Wynik: "Hello" (zawartość domyślnego locale)

Używanie niestandardowych typów zawartości:

import { getTranslationContent, Locales } from "intlayer";

const customContent = getTranslationContent<Record<string, string>>(
  {
    en: { greeting: "Hello" },
    fr: { greeting: "Bonjour" },
  },
  Locales.FRENCH
);

console.log(customContent.greeting); // Wynik: "Bonjour"

Przypadki brzegowe

• Nie znaleziono locale:
  • Gdy locale nie zostanie znalezione w languageContent, funkcja zwraca zawartość dla domyślnego locale.
• Niekompletna zawartość językowa:
  • Jeśli locale jest zdefiniowane częściowo, funkcja nie łączy zawartości. Ściśle pobiera wartość określonego locale lub wraca do domyślnego.
• Wymuszenie przez TypeScript:
  • Jeśli locale w languageContent nie odpowiadają konfiguracji projektu, TypeScript wymusi zdefiniowanie wszystkich wymaganych locale, zapewniając, że zawartość jest kompletna i bezpieczna typowo.