Penulis:
    Aymeric PINEAU
    Dibuat:2026-01-21Terakhir diperbarui:2026-01-21

    Paket react-intlayer

    Paket react-intlayer menyediakan alat yang diperlukan untuk mengintegrasikan Intlayer ke dalam aplikasi React. Paket ini mencakup context providers, hooks, dan komponen untuk menangani konten multibahasa.

    Instalasi

    bash
    npm install react-intlayer

    Ekspor

    Penyedia

    Impor:

    tsx
    import "react-intlayer";
    KomponenDeskripsiDokumen Terkait
    IntlayerProviderProvider utama yang membungkus aplikasi Anda dan menyediakan konteks Intlayer. Menyertakan dukungan editor secara default.IntlayerProvider
    IntlayerProviderContentKomponen provider yang fokus pada konten tanpa fitur editor. Gunakan ini ketika Anda tidak membutuhkan editor visual.-
    HTMLProviderProvider untuk pengaturan internasionalisasi terkait HTML. Mengizinkan override komponen untuk tag HTML.-

    Hooks

    Impor:

    tsx
    import "react-intlayer";
    HookDeskripsiDokumen Terkait
    useIntlayerHook di sisi klien yang memilih satu dictionary berdasarkan key-nya dan mengembalikan kontennya. Menggunakan locale dari context jika tidak disediakan.useIntlayer
    useDictionaryHook yang mentransformasikan objek dictionary dan mengembalikan konten untuk locale saat ini. Memproses terjemahan t(), enumerasi, dll.useDictionary
    useDictionaryAsyncHook yang menangani dictionary asinkron. Menerima peta dictionary berbasis promise dan menyelesaikannya untuk locale saat ini.-
    useDictionaryDynamicHook yang menangani dictionary dinamis yang dimuat berdasarkan key. Menggunakan React Suspense secara internal untuk status pemuatan.-
    useLocaleHook sisi-klien untuk mendapatkan locale saat ini, defaultLocale, availableLocales, dan fungsi untuk memperbarui locale.useLocale
    useLocaleBaseHook untuk mendapatkan locale saat ini dan semua field terkait (locale, defaultLocale, availableLocales, setLocale) dari context.-
    usePathnameHook yang mengembalikan nama path (pathname) saat ini dengan segmen lokal (locale) dihapus. Reaktif terhadap navigasi browser melalui popstate.usePathname
    useRewriteURLClient-side hook untuk mengelola rewrite URL. Jika ada aturan rewrite untuk pathname dan locale saat ini, hook ini akan memperbarui URL.useRewriteURL
    useI18nHook yang menyediakan fungsi terjemahan t() untuk mengakses konten bersarang berdasarkan kunci. Meniru pola i18next/next-intl.useI18n
    useIntlHook yang menyediakan objek Intl yang terikat pada locale. Secara otomatis menyuntikkan locale saat ini dan menggunakan caching yang dioptimalkan.-
    useLocaleStorageHook yang menyediakan persistensi locale di local storage atau cookie. Mengembalikan fungsi getter dan setter.-
    useLocaleCookieTidak lagi direkomendasikan. Gunakan useLocaleStorage sebagai gantinya. Hook yang mengelola persistensi locale di cookie.-
    useLoadDynamicHook untuk memuat kamus dinamis menggunakan React Suspense. Menerima sebuah key dan promise, serta mencache hasilnya.-
    useIntlayerContextHook yang menyediakan nilai konteks klien Intlayer saat ini (locale, setLocale, dll.).-
    useHTMLContextHook untuk mengakses override komponen HTML dari konteks HTMLProvider.-

    Fungsi

    Impor:

    tsx
    import "react-intlayer";
    FungsiDeskripsiDokumen Terkait
    tFungsi terjemahan sisi klien yang mengembalikan terjemahan dari konten multibahasa yang diberikan. Menggunakan locale dari konteks jika tidak disediakan.terjemahan
    getDictionaryMemproses objek kamus dan mengembalikan konten untuk locale yang ditentukan. Memproses terjemahan t(), enumerasi, markdown, HTML, dll.-
    getIntlayerMengambil kamus berdasarkan kunci dari deklarasi yang dihasilkan dan mengembalikan kontennya untuk locale yang ditentukan. Versi teroptimasi dari getDictionary.-
    setLocaleInStorageMengatur locale di penyimpanan (local storage atau cookie berdasarkan konfigurasi).-
    setLocaleCookieDeprecated. Gunakan setLocaleInStorage sebagai gantinya. Mengatur locale dalam cookie.-
    localeInStorageMendapatkan locale dari penyimpanan (local storage atau cookie).-
    localeCookieTidak direkomendasikan. Gunakan localeInStorage sebagai gantinya. Mendapatkan locale dari cookie.-

    Komponen

    Impor:

    tsx
    import "react-intlayer";

    atau

    tsx
    import "react-intlayer/markdown";
    KomponenDeskripsiDokumen Terkait
    MarkdownProviderProvider untuk konteks rendering markdown. Memungkinkan override komponen kustom untuk elemen markdown.-
    MarkdownRendererMerender konten markdown dengan komponen kustom. Mendukung semua fitur markdown standar dan sintaks khusus Intlayer.MarkdownRenderer

    Tipe

    Impor:

    tsx
    import "react-intlayer";
    TipeDeskripsi
    IntlayerNodeTipe yang merepresentasikan sebuah node dalam pohon konten Intlayer. Digunakan untuk manipulasi konten yang type-safe.

    Sisi server (react-intlayer/server)

    Impor:

    tsx
    import "react-intlayer/server";
    EksporTipeDeskripsi
    IntlayerServerProviderComponentProvider untuk rendering sisi server.
    IntlayerServerComponentPembungkus sisi server untuk konten Intlayer.
    tFunctionVersi sisi server dari fungsi terjemahan.
    useLocaleHookHook untuk mengakses locale di sisi server.
    useIntlayerHookVersi server-side dari useIntlayer.
    useDictionaryHookVersi server-side dari useDictionary.
    useI18nHookVersi server-side dari useI18n.
    localeFunctionFungsi untuk mendapatkan atau mengatur locale di server.
    validatePrefixIntlayerProvider