Dokümantasyon: intlayer Paketinde getTranslation Fonksiyonu

Açıklama

getTranslation fonksiyonu, özelleştirilebilir dil içeriğinin bir kümesinden belirli bir yerel ayara karşılık gelen içeriği alır. Belirtilen yerel ayar bulunamazsa, projede yapılandırılan varsayılan yerel ayar için içeriği döndürür.

Parametreler

• languageContent: CustomizableLanguageContent<Content>

  • Açıklama: Çeşitli yerel ayarlar için çeviriler içeren bir nesne. Her anahtar bir yerel ayarı temsil eder ve değeri karşılık gelen içeriktir.
  • Tür: CustomizableLanguageContent<Content>
    • Content herhangi bir tür olabilir, varsayılan olarak string.

• locale: Locales

  • Açıklama: İçeriğin alınacağı yerel ayar.
  • Tür: Locales

Döndürür

• Tür: Content
• Açıklama: Belirtilen yerel ayara karşılık gelen içerik. Yerel ayar bulunamazsa, varsayılan yerel ayar için içerik döndürülür.

Kullanım Örneği

Temel Kullanım

import { getTranslation, Locales } from "intlayer";const content = getTranslation(  {    en: "Hello",    fr: "Bonjour",  },  Locales.ENGLISH);console.log(content); // Çıktı: "Bonjour"

Eksik Yerel Ayar:

import { getTranslation, Locales } from "intlayer";const content = getTranslation(  {    en: "Hello",    fr: "Bonjour",  },  Locales.SPANISH);console.log(content); // Çıktı: "Hello" (varsayılan yerel ayar içeriği)

Özel İçerik Türlerini Kullanma:

import { getTranslation, Locales } from "intlayer";const customContent = getTranslation<Record<string, string>>(  {    en: { greeting: "Hello" },    fr: { greeting: "Bonjour" },  },  Locales.FRENCH);console.log(customContent.greeting); // Çıktı: "Bonjour"

Kenar Durumları

• Yerel Ayar Bulunamadı:
  • locale languageContent'te bulunamadığında, fonksiyon varsayılan yerel ayar için içeriği döndürür.
• Eksik Dil İçeriği:
  • Bir yerel ayar kısmen tanımlanmışsa, fonksiyon içerikleri birleştirmez. Kesinlikle belirtilen yerel ayarın değerini alır veya varsayılana geri döner.
• TypeScript Zorlaması:
  • languageContent'teki yerel ayarlar proje yapılandırmasıyla eşleşmezse, TypeScript tüm gerekli yerel ayarların tanımlanmasını zorunlu kılar, böylece içerik tam ve tür açısından güvenli olur.

Dokümantasyon Geçmişi