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

    next-intlayer Paketi

    next-intlayer paketi, Intlayer'ı Next.js uygulamalarına entegre etmek için gerekli araçları sağlar. Hem App Router hem de Page Router'ı destekler; locale tabanlı yönlendirme için middleware içerir.

    Kurulum

    bash
    npm install next-intlayer

    Dışa Aktarımlar

    Ara Katman (Middleware)

    İçe aktarma:

    tsx
    import "next-intlayer/middleware";
    FunctionAçıklamaİlgili Doküman
    intlayerMiddlewareNext.js middleware, locale tabanlı yönlendirmeleri ve redirect'leri yönetmek için. Başlıklardan/çerezlerden locale'i algılar ve uygun locale yoluna yönlendirir.intlayerMiddleware

    Yapılandırma Yardımcıları

    İçe aktar:

    tsx
    import "next-intlayer/server";
    FonksiyonAçıklamaİlgili Doküman
    withIntlayerNext.js yapılandırmasını sarmalamak için asenkron yardımcı; Intlayer sözlüklerinin derleme öncesinde hazırlanmasını sağlar. İçerik dosyalarını hazırlar ve webpack/SWC eklentilerini yapılandırır.-
    withIntlayerSyncNext.js yapılandırmasını sarmalamak için senkron yardımcı; asenkronun mümkün veya istenmediği konfigürasyonlar için idealdir. Sunucu başlatıldığında sözlükleri hazırlamaz.-

    Sağlayıcılar

    İçe aktar:

    tsx
    import "next-intlayer";

    veya

    tsx
    import "next-intlayer/server";
    BileşenAçıklamaİlgili Dok.
    IntlayerClientProviderNext.js App Router'daki istemci tarafı bileşenler için sağlayıcı. react-intlayer'dan IntlayerProvider'ı sarar.-
    IntlayerServerProviderNext.js (App Router) içindeki sunucu tarafı bileşenler için sağlayıcı. Sunucuda locale bağlamı sağlar.-
    IntlayerServerApp Router'da Intlayer içeriği için sunucu tarafı sarmalayıcı. Server Components'te doğru locale yönetimini sağlar.-

    Hook'lar (İstemci tarafı)

    Import:

    tsx
    import "next-intlayer";

    Re-exports most hooks from react-intlayer.

    HookAçıklamaİlgili Doküman
    useIntlayerİstemci tarafında, anahtarı ile bir sözlüğü seçip içeriğini döndüren hook. Sağlanmazsa locale'i context'ten alır.useIntlayer
    useDictionaryBir sözlük 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 sözlükleri yöneten hook. Promise tabanlı bir sözlük haritası kabul eder ve mevcut locale için çözer.-
    useDictionaryDynamicAnahtara göre yüklenen dinamik sözlükleri yöneten hook. Yükleme durumları için dahili olarak React Suspense kullanır.-
    useLocaleİstemci tarafı hook; geçerli locale'i alır ve bunu ayarlamak için bir fonksiyon sağlar. Next.js App Router için navigasyon desteğiyle geliştirilmiştir.useLocale
    usePathnameYerel ayar öneki kaldırılmış ve yerel ayar parametrelerinden arındırılmış sorgu parametreleri ile mevcut yol adını döndürür.usePathname
    useRewriteURLURL yeniden yazmalarını yönetmek için istemci tarafı hook. Daha uygun bir yerelleştirilmiş yeniden yazma kuralı varsa URL'yi otomatik olarak günceller.useRewriteURL
    useLocalePageRouterNext.js Page Router'a özgü yerelleştirme yönetimi için hook. Dil değişikliklerinde yönlendirmeleri ve sayfa yeniden yüklemelerini işler.-
    useI18nAnahtar kullanarak iç içe geçmiş içeriğe erişen t() çeviri fonksiyonunu sağlayan hook. i18next/next-intl desenini taklit eder.useI18n
    useIntlLocale ile bağlı bir Intl nesnesi sağlayan hook. Geçerli locale'i otomatik olarak enjekte eder ve optimize edilmiş önbellekleme kullanır.-
    useLoadDynamicReact Suspense kullanarak dinamik sözlükleri yüklemek için hook. Bir key ve promise kabul eder, sonuçları önbelleğe alır.-

    Fonksiyonlar (Sunucu tarafı)

    İçe Aktarma:

    tsx
    import "next-intlayer/server";
    FonksiyonAçıklamaİlgili Doküman
    tNext.js App Router için sunucu tarafı çeviri fonksiyonunun sürümü. Sunucunun locale'ı için çokdilli içeriğin çevirisini döndürür.çeviri
    getLocaleNext.js başlıklarından (headers) ve çerezlerden (cookies) mevcut locale'ı çıkaran yardımcı fonksiyon. Server Components, Server Actions veya Route Handlers için tasarlanmıştır.-
    generateStaticParamsYapılandırılmış locale'lere göre Next.js'in dinamik rotaları için statik parametreler üretir. Önceden render (pre-render) için locale nesnelerinden oluşan bir dizi döndürür.-
    localeSunucu bağlamında (App Router) locale'i almak veya ayarlamak için bir fonksiyon. Server Component'lerde locale yönetimi sağlar.-

    Türler

    İçe aktarma:

    tsx
    import "next-intlayer";
    TürAçıklama
    NextPageIntlayerIntlayer desteği olan Next.js sayfaları için tip. Locale parametresini içeren generic tip.
    Next14PageIntlayerIntlayer desteği olan Next.js 14 sayfaları için tip.
    Next15PageIntlayerIntlayer desteği olan Next.js 15 sayfaları için tip.
    NextLayoutIntlayerIntlayer desteği olan Next.js layout'ları için tip. Locale parametresini içeren generic tip.
    Next14LayoutIntlayerIntlayer desteğine sahip Next.js 14 layout'ları için tip.
    Next15LayoutIntlayerIntlayer desteğine sahip Next.js 15 layout'ları için tip.
    LocalParamsYerelleştirme içeren Next.js rota parametreleri için tip. locale özelliğine sahip bir nesne.
    LocalPromiseParamsYerelleştirme içeren Next.js rota parametreleri için tip (async sürüm). locale özelliğine sahip bir nesneyle çözülen Promise.
    useRewriteURLintlayerMiddleware