Dokumentasi: Fungsi getTranslation di intlayer

Deskripsi

Fungsi getTranslation 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.

Parameter

• languageContent: CustomizableLanguageContent<Content>

  • Deskripsi: Sebuah 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 { getTranslation, Locales } from "intlayer";const content = getTranslation(  {    en: "Hello",    fr: "Bonjour",  },  Locales.ENGLISH);console.log(content); // Output: "Bonjour"

Locale yang Hilang:

import { getTranslation, Locales } from "intlayer";const content = getTranslation(  {    en: "Hello",    fr: "Bonjour",  },  Locales.SPANISH);console.log(content); // Output: "Hello" (konten locale default)

Menggunakan Tipe Konten Kustom:

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

Kasus Tepi

• 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 locales dalam languageContent tidak sesuai dengan konfigurasi proyek, TypeScript akan menegakkan semua locales yang diperlukan untuk didefinisikan, memastikan konten lengkap dan aman tipe.