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

الوصف

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

المعاملات

• languageContent: CustomizableLanguageContent<Content>

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

• locale: Locales

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

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

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

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

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

import { getTranslation, Locales } from "intlayer";const content = getTranslation(  {    en: "Hello",    fr: "Bonjour",  },  Locales.ENGLISH);console.log(content); // الناتج: "Bonjour"

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

import { getTranslation, Locales } from "intlayer";const content = getTranslation(  {    en: "Hello",    fr: "Bonjour",  },  Locales.SPANISH);console.log(content); // الناتج: "Hello" (محتوى اللغة الافتراضية)

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

import { getTranslation, Locales } from "intlayer";const customContent = getTranslation<Record<string, string>>(  {    en: { greeting: "Hello" },    fr: { greeting: "Bonjour" },  },  Locales.FRENCH);console.log(customContent.greeting); // الناتج: "Bonjour"

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

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

تاريخ الوثيقة

• 5.5.10 - 2025-06-29: بداية التاريخ