Dokumentasi: Fungsi getMultilingualUrls di intlayer

Deskripsi

Fungsi getMultilingualUrls menghasilkan pemetaan URL multibahasa dengan menambahkan prefix locale yang didukung pada URL yang diberikan. Fungsi ini dapat menangani URL absolut maupun relatif, dengan menerapkan prefix locale yang sesuai berdasarkan konfigurasi yang diberikan atau nilai default.

Parameter

• url: string

  • Deskripsi: String URL asli yang akan diberi prefix locale.
  • Tipe: string

• locales: Locales[]

  • Deskripsi: Array opsional dari locale yang didukung. Defaultnya adalah locale yang dikonfigurasi dalam proyek.
  • Tipe: Locales[]
  • Default: localesDefault

• defaultLocale: Locales

  • Deskripsi: Locale default untuk aplikasi. Defaultnya adalah locale default yang dikonfigurasi dalam proyek.
  • Tipe: Locales
  • Default: defaultLocaleDefault

• prefixDefault: boolean

  • Deskripsi: Apakah akan menambahkan prefix pada locale default. Defaultnya adalah nilai yang dikonfigurasi dalam proyek.
  • Tipe: boolean
  • Default: prefixDefaultDefault

Mengembalikan

• Tipe: IConfigLocales<string>
• Deskripsi: Objek yang memetakan setiap locale ke URL multibahasa yang sesuai.

Contoh Penggunaan

URL Relatif

import { getMultilingualUrls, Locales } from "intlayer";

getMultilingualUrls(
  "/dashboard",
  [Locales.ENGLISH, Locales.FRENCH],
  Locales.ENGLISH,
  false
);
// Output: {
//   en: "/dashboard",
//   fr: "/fr/dashboard"
// }

URL Absolut

getMultilingualUrls(  "https://example.com/dashboard",  [Locales.ENGLISH, Locales.FRENCH],  Locales.ENGLISH,  true);// Output: {//   en: "https://example.com/en/dashboard",//   fr: "https://example.com/fr/dashboard"// }

Kasus Tepi

• Tidak Ada Segmen Locale:

  • Fungsi menghapus segmen locale yang sudah ada dari URL sebelum menghasilkan pemetaan multibahasa.

• Locale Default:

  • Ketika prefixDefault adalah false, fungsi tidak menambahkan prefix pada URL untuk locale default.

• Locale yang Tidak Didukung:

  • Hanya locale yang disediakan dalam array locales yang dipertimbangkan untuk menghasilkan URL.

Penggunaan dalam Aplikasi

Dalam aplikasi multibahasa, mengonfigurasi pengaturan internasionalisasi dengan locales dan defaultLocale sangat penting untuk memastikan bahasa yang benar ditampilkan. Berikut adalah contoh bagaimana getMultilingualUrls dapat digunakan dalam pengaturan aplikasi:

import { Locales, type IntlayerConfig } from "intlayer";

// Konfigurasi untuk locale yang didukung dan locale default
export default {
  internationalization: {
    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
    defaultLocale: Locales.ENGLISH,
  },
} satisfies IntlayerConfig;

export default config;

Konfigurasi di atas memastikan bahwa aplikasi mengenali ENGLISH, FRENCH, dan SPANISH sebagai bahasa yang didukung dan menggunakan ENGLISH sebagai bahasa fallback.

Dengan menggunakan konfigurasi ini, fungsi getMultilingualUrls dapat secara dinamis menghasilkan pemetaan URL multibahasa berdasarkan locale yang didukung oleh aplikasi:

getMultilingualUrls(  "/dashboard",  [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],  Locales.ENGLISH);// Output:// {//   en: "/dashboard",//   fr: "/fr/dashboard",//   es: "/es/dashboard"// }getMultilingualUrls(  "https://example.com/dashboard",  [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],  Locales.ENGLISH,  true);// Output:// {//   en: "https://example.com/en/dashboard",//   fr: "https://example.com/fr/dashboard",//   es: "https://example.com/es/dashboard"// }

Dengan mengintegrasikan getMultilingualUrls, pengembang dapat mempertahankan struktur URL yang konsisten di berbagai bahasa, meningkatkan pengalaman pengguna sekaligus SEO.