Dokumentasi: Fungsi getCanonicalPath di intlayer

Deskripsi

Fungsi getCanonicalPath mengonversi path URL yang dilokalkan (mis. /a-propos) kembali ke path kanonik internal aplikasi (mis. /about). Ini penting agar router dapat mencocokkan rute internal yang benar terlepas dari bahasa pada URL.

Fitur Utama:

• Mendukung parameter rute dinamis menggunakan sintaks [param].
• Mencocokkan path yang dilokalkan dengan aturan rewrite kustom yang didefinisikan dalam konfigurasi Anda.
• Mengembalikan path asli jika tidak ditemukan aturan rewrite yang cocok.

Tanda Tangan Fungsi

getCanonicalPath(  localizedPath: string,         // Diperlukan  locale: Locales,               // Diperlukan  rewriteRules?: RoutingConfig['rewrite'] // Opsional): string

Parameter

Parameter Wajib

• localizedPath: string

  • Deskripsi: Jalur yang dilokalkan sebagaimana terlihat di browser (mis. /a-propos).
  • Tipe: string
  • Diperlukan: Ya

• locale: Locales

  • Deskripsi: Locale yang digunakan untuk jalur yang sedang di-resolve.
  • Tipe: Locales
  • Diperlukan: Ya

Parameter Opsional

• rewriteRules?: RoutingConfig['rewrite']
  • Deskripsi: Objek yang mendefinisikan aturan rewrite kustom. Jika tidak disediakan, akan default ke properti routing.rewrite dari konfigurasi proyek Anda.
  • Tipe: RoutingConfig['rewrite']
  • Default: configuration.routing.rewrite

Pengembalian

• Tipe: string
• Deskripsi: Jalur kanonis internal.

Contoh Penggunaan

Penggunaan Dasar (Dengan Konfigurasi)

Jika Anda telah mengonfigurasi rewrite kustom di intlayer.config.ts Anda:

import { getCanonicalPath, Locales } from "intlayer";// Konfigurasi: { '/about': { en: '/about', fr: '/a-propos' } }getCanonicalPath("/a-propos", Locales.FRENCH);// Keluaran: "/about"getCanonicalPath("/about", Locales.ENGLISH);// Keluaran: "/about"

Penggunaan dengan Rute Dinamis

import { getCanonicalPath, Locales } from "intlayer";// Konfigurasi: { '/product/[id]': { en: '/product/[id]', fr: '/produit/[id]' } }getCanonicalPath("/produit/123", Locales.FRENCH);// Keluaran: "/product/123"

Aturan Rewrite Manual

Anda juga dapat memberikan aturan rewrite manual ke fungsi:

import { getCanonicalPath, Locales } from "intlayer";const manualRules = {  "/contact": {    en: "/contact-us",    fr: "/contactez-nous",  },};getCanonicalPath("/contactez-nous", Locales.FRENCH, manualRules);// Keluaran: "/contact"

Fungsi Terkait

• getLocalizedPath: Menyelesaikan path kanonis menjadi padanan lokalnya.
• getLocalizedUrl: Menghasilkan URL yang sepenuhnya dilokalkan (termasuk protokol, host, dan prefix locale).