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

    npm install next-intlayer

    Dışa Aktarımlar

    Ara Katman (Middleware)

    İçe aktarma:

    import "next-intlayer/middleware";
    Function Açıklama İlgili Doküman
    intlayerMiddleware Next.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:

    import "next-intlayer/server";
    Fonksiyon Açıklama İlgili Doküman
    withIntlayer Next.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. -
    withIntlayerSync Next.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:

    import "next-intlayer";

    veya

    import "next-intlayer/server";
    Bileşen Açıklama İlgili Dok.
    IntlayerClientProvider Next.js App Router'daki istemci tarafı bileşenler için sağlayıcı. react-intlayer'dan IntlayerProvider'ı sarar. -
    IntlayerServerProvider Next.js (App Router) içindeki sunucu tarafı bileşenler için sağlayıcı. Sunucuda locale bağlamı sağlar. -
    IntlayerServer App 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:

    import "next-intlayer";

    Re-exports most hooks from react-intlayer.

    Hook Açı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
    useDictionary Bir 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
    useDictionaryAsync Asenkron sözlükleri yöneten hook. Promise tabanlı bir sözlük haritası kabul eder ve mevcut locale için çözer. -
    useDictionaryDynamic Anahtara 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
    useRewriteURL URL 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
    useLocalePageRouter Next.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. -
    useI18n Anahtar kullanarak iç içe geçmiş içeriğe erişen t() çeviri fonksiyonunu sağlayan hook. i18next/next-intl desenini taklit eder. useI18n
    useIntl Locale ile bağlı bir Intl nesnesi sağlayan hook. Geçerli locale'i otomatik olarak enjekte eder ve optimize edilmiş önbellekleme kullanır. -
    useLoadDynamic React 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:

    import "next-intlayer/server";
    Fonksiyon Açıklama İlgili Doküman
    t Next.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
    getLocale Next.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. -
    generateStaticParams Yapı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. -
    locale Sunucu 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:

    import "next-intlayer";
    Tür Açıklama
    NextPageIntlayer Intlayer desteği olan Next.js sayfaları için tip. Locale parametresini içeren generic tip.
    Next14PageIntlayer Intlayer desteği olan Next.js 14 sayfaları için tip.
    Next15PageIntlayer Intlayer desteği olan Next.js 15 sayfaları için tip.
    NextLayoutIntlayer Intlayer desteği olan Next.js layout'ları için tip. Locale parametresini içeren generic tip.
    Next14LayoutIntlayer Intlayer desteğine sahip Next.js 14 layout'ları için tip.
    Next15LayoutIntlayer Intlayer desteğine sahip Next.js 15 layout'ları için tip.
    LocalParams Yerelleştirme içeren Next.js rota parametreleri için tip. locale özelliğine sahip bir nesne.
    LocalPromiseParams Yerelleştirme içeren Next.js rota parametreleri için tip (async sürüm). locale özelliğine sahip bir nesneyle çözülen Promise.
    Neden Intlayer?