Yazar:
    Aymeric PINEAU
    Oluşturma:2026-01-21Son güncelleme:2026-01-21

    react-intlayer Paketi

    react-intlayer paketi, Intlayer'ı React uygulamalarına entegre etmek için gerekli araçları sağlar. Çok dilli içeriği işlemek için context sağlayıcıları, hook'lar ve bileşenler içerir.

    Kurulum

    bash
    npm install react-intlayer

    Dışa Aktarılanlar

    Sağlayıcılar

    Import:

    tsx
    import "react-intlayer";
    BileşenAçıklamaİlgili Doküman
    IntlayerProviderUygulamanızı saran ve Intlayer bağlamını sağlayan ana provider. Varsayılan olarak editör desteği içerir.IntlayerProvider
    IntlayerProviderContentEditör özellikleri olmadan içeriğe odaklanan bir provider bileşeni. Görsel editöre ihtiyacınız olmadığında bunu kullanın.-
    HTMLProviderHTML ile ilgili uluslararasılaştırma ayarları için provider. HTML etiketleri için bileşen geçersiz kılmalarına izin verir.-

    Hook'lar

    İçe Aktarma:

    tsx
    import "react-intlayer";
    HookAçıklamaİlgili Doküman
    useIntlayerAnahtarıyla bir sözlüğü seçen ve içeriğini döndüren istemci tarafı hook'u. Sağlanmazsa bağlamdan locale'i kullanır.useIntlayer
    useDictionaryBir dictionary nesnesini dönüştüren ve geçerli locale için içeriği döndüren hook. t() çevirilerini, enum'ları vb. işler.useDictionary
    useDictionaryAsyncAsenkron dictionary'leri yöneten hook. Promise tabanlı bir dictionary map'i kabul eder ve geçerli locale için çözer.-
    useDictionaryDynamicAnahtara göre yüklenen dinamik sözlükleri işleyen hook. Yükleme durumları için dahili olarak React Suspense kullanır.-
    useLocaleİstemci tarafı hook; geçerli locale'i, varsayılan locale'i, kullanılabilir locale'leri ve locale'i güncellemek için bir fonksiyonu alır.useLocale
    useLocaleBaseContext'ten geçerli locale ve ilgili tüm alanları (locale, defaultLocale, availableLocales, setLocale) almak için hook.-
    usePathnameYerel ayar segmenti kaldırılmış olarak mevcut yol adını (pathname) döndüren kanca. popstate üzerinden tarayıcı gezinmesine duyarlıdır.usePathname
    useRewriteURLURL yeniden yazmalarını yönetmek için istemci tarafı hook. Geçerli pathname ve locale için bir rewrite kuralı varsa, URL'i günceller.useRewriteURL
    useI18nAnahtara göre iç içe geçmiş içeriğe erişmek için t() çeviri fonksiyonunu sağlayan Hook. i18next/next-intl modelini taklit eder.useI18n
    useIntlLocale'e bağlı bir Intl nesnesi sağlayan Hook. Geçerli locale'i otomatik olarak enjekte eder ve optimize edilmiş önbellekleme kullanır.-
    useLocaleStorageLocal storage (localStorage) veya çerezlerde (cookies) locale kalıcılığı sağlayan Hook. Getter ve setter fonksiyonları döndürür.-
    useLocaleCookieKullanımdan kaldırıldı. Bunun yerine useLocaleStorage kullanın. Çerezlerde locale kalıcılığını yöneten Hook.-
    useLoadDynamicReact Suspense kullanarak dinamik sözlükleri yüklemek için hook. Bir key ve Promise kabul eder; sonuçları önbelleğe alır.-
    useIntlayerContextGeçerli Intlayer istemci context değerlerini (locale, setLocale vb.) sağlayan hook.-
    useHTMLContextHTMLProvider bağlamından HTML bileşenlerinin override'larına erişmek için Hook.-

    Fonksiyonlar

    İçe Aktar:

    tsx
    import "react-intlayer";
    FonksiyonAçıklamaİlgili Doküman
    tSağlanan çok dilli içeriğin çevirisini döndüren istemci tarafı çeviri fonksiyonu. parametre olarak locale verilmezse context locale'i kullanır.translation
    getDictionaryDictionary nesnelerini işler ve belirtilen locale için içeriği döndürür. t() çevirilerini, enumerasyonları, markdown, HTML vb. işler.-
    getIntlayerOluşturulan deklarasyondan anahtarıyla bir dictionary alır ve belirtilen locale için içeriğini döndürür. getDictionary'nin optimize edilmiş versiyonu.-
    setLocaleInStorageLocale'i depolamada ayarlar (yapılandırmaya bağlı olarak local storage veya cookie).-
    setLocaleCookieKullanımdan kaldırıldı. Bunun yerine setLocaleInStorage kullanın. Locale'i bir cookie'de ayarlar.-
    localeInStorageDepolamadan locale alır (localStorage veya çerez).-
    localeCookieKullanımdan kaldırıldı. Bunun yerine localeInStorage kullanın. Çerezden locale alır.-

    Bileşenler

    İçe aktar:

    tsx
    import "react-intlayer";

    veya

    tsx
    import "react-intlayer/markdown";
    BileşenAçıklamaİlgili Doküman
    MarkdownProviderMarkdown renderleme bağlamı için sağlayıcı. Markdown öğeleri için özel bileşenlerin geçersiz kılınmasına izin verir.-
    MarkdownRendererÖzel bileşenlerle markdown içeriğini render eder. Tüm standart markdown özelliklerini ve Intlayer'a özgü sözdizimini destekler.MarkdownRenderer

    Türler

    İçe aktarma:

    tsx
    import "react-intlayer";
    TürAçıklama
    IntlayerNodeIntlayer içerik ağacındaki bir düğümü temsil eden tür. Tür güvenli içerik manipülasyonu için kullanılır.

    Sunucu tarafı (react-intlayer/server)

    Import:

    tsx
    import "react-intlayer/server";
    Dışa AktarımTürAçıklama
    IntlayerServerProviderComponentSunucu tarafı render için sağlayıcı.
    IntlayerServerComponentIntlayer içeriği için sunucu tarafı sarmalayıcı.
    tFunctionÇeviri fonksiyonunun sunucu tarafı versiyonu.
    useLocaleHookSunucu tarafında locale'ye erişmek için Hook.
    useIntlayerHookuseIntlayer'in sunucu tarafı sürümü.
    useDictionaryHookuseDictionary'in sunucu tarafı sürümü.
    useI18nHookuseI18n'in sunucu tarafı sürümü.
    localeFunctionSunucuda locale'i almak veya ayarlamak için fonksiyon.
    validatePrefixIntlayerProvider