التوثيق: دالة getTranslationContent في intlayer

الوصف

تقوم دالة getTranslationContent باسترجاع المحتوى المقابل للغة معينة من مجموعة محتويات لغوية قابلة للتخصيص. إذا لم يتم العثور على اللغة المحددة، فإنها تعيد بشكل افتراضي المحتوى الخاص باللغة الافتراضية المكونة في المشروع.

المعاملات

• languageContent: CustomizableLanguageContent<Content>

  • الوصف: كائن يحتوي على ترجمات لمختلف اللغات. كل مفتاح يمثل لغة، وقيمته هي المحتوى المقابل.
  • النوع: CustomizableLanguageContent<Content>
    • يمكن أن يكون Content أي نوع، والافتراضي هو string.

• locale: Locales

  • الوصف: اللغة التي سيتم استرجاع المحتوى الخاص بها.
  • النوع: Locales

القيم المرجعة

• النوع: Content
• الوصف: المحتوى المقابل للغة المحددة. إذا لم يتم العثور على اللغة، يتم إرجاع محتوى اللغة الافتراضية.

مثال على الاستخدام

الاستخدام الأساسي

import { getTranslationContent, Locales } from "intlayer";

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

console.log(content); // الناتج: "Bonjour"

اللغة غير موجودة:

import { getTranslationContent, Locales } from "intlayer";

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

console.log(content); // الناتج: "Hello" (محتوى اللغة الافتراضية)

استخدام أنواع المحتوى المخصصة:

import { getTranslationContent, Locales } from "intlayer";

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

console.log(customContent.greeting); // الناتج: "Bonjour"

الحالات الخاصة

• اللغة غير موجودة:
  • عندما لا يتم العثور على locale في languageContent، تقوم الدالة بإرجاع المحتوى الخاص باللغة الافتراضية.
• محتوى اللغة غير مكتمل:
  • إذا تم تعريف اللغة جزئيًا، فإن الدالة لا تدمج المحتويات. تسترجع بدقة قيمة اللغة المحددة أو تعود إلى اللغة الافتراضية.
• فرض TypeScript:
  • إذا لم تتطابق اللغات في languageContent مع تكوين المشروع، فإن TypeScript ستفرض تعريف جميع اللغات المطلوبة، مما يضمن أن المحتوى كامل وآمن من حيث النوع.