Dokumentasi: Fungsi getTranslationContent di intlayer

Deskripsi

Fungsi getTranslationContent mengambil konten yang sesuai dengan locale tertentu dari sekumpulan konten bahasa yang dapat disesuaikan. Jika locale yang ditentukan tidak ditemukan, fungsi ini akan mengembalikan konten untuk locale default yang dikonfigurasi dalam proyek.

Untuk detail lebih lanjut tentang cara mendeklarasikan terjemahan, lihat dokumentasi Translation.

Parameter

• languageContent: CustomizableLanguageContent<Content>

  • Deskripsi: Objek yang berisi terjemahan untuk berbagai locale. Setiap kunci mewakili sebuah locale, dan nilainya adalah konten yang sesuai.
  • Tipe: CustomizableLanguageContent<Content>
    • Content dapat berupa tipe apa saja, dengan default string.

• locale: Locales

  • Deskripsi: Locale yang kontennya akan diambil.
  • Tipe: Locales

Mengembalikan

• Tipe: Content
• Deskripsi: Konten yang sesuai dengan locale yang ditentukan. Jika locale tidak ditemukan, konten dari locale default akan dikembalikan.

Contoh Penggunaan

Penggunaan Dasar

import { getTranslationContent, Locales } from "intlayer";

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

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

Locale yang Hilang:

import { getTranslationContent, Locales } from "intlayer";

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

console.log(content); // Output: "Hello" (konten locale default)

Menggunakan Tipe Konten Kustom:

import { getTranslationContent, Locales } from "intlayer";

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

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

Kasus Khusus

• Locale Tidak Ditemukan:
  • Ketika locale tidak ditemukan dalam languageContent, fungsi mengembalikan konten untuk locale default.
• Konten Bahasa Tidak Lengkap:
  • Jika sebuah locale hanya didefinisikan sebagian, fungsi tidak menggabungkan konten. Fungsi secara ketat mengambil nilai dari locale yang ditentukan atau kembali ke default.
• Penegakan TypeScript:
  • Jika locale dalam languageContent tidak sesuai dengan konfigurasi proyek, TypeScript akan menegakkan semua locale yang diperlukan untuk didefinisikan, memastikan konten lengkap dan aman secara tipe.