Yazar:
    Oluşturma:2026-09-19Son güncelleme:2026-09-19

    useLocale Hook Dokümantasyonu

    remix-intlayer paketindeki useLocale hook'u, o anda işlenmekte olan HTTP isteğinin yerel ayarına ve ayrıca projede yapılandırılmış varsayılan ve kullanılabilir yerel ayarlara erişim sağlar.

    Kullanım

    Bir Remix bileşeninde (örneğin bir dil değiştirici):

    src/components/LocaleSwitcher.tsx
    import { type FC } from "react";
    import { Link } from "@remix-run/react";
    import { useLocale } from "remix-intlayer";
    import { getLocalizedUrl, getPathWithoutLocale } from "intlayer";
    
    export const LocaleSwitcher: FC = () => {
      const { locale, availableLocales } = useLocale();
      const pathWithoutLocale = getPathWithoutLocale();
    
      return (
        <nav>
          <ul>
            {availableLocales.map((localeItem) => (
              <li key={localeItem} className="p-1">
                <Link
                  href={getLocalizedUrl(pathWithoutLocale, localeItem)}
                  aria-current={localeItem === locale ? "page" : undefined}
                >
                  {localeItem.toUpperCase()}
                </Link>
              </li>
            ))}
          </ul>
        </nav>
      );
    };
    

    Bir rota işleyicisinde:

    src/server.ts
    import { createRouter } from "remix/router";
    import { intlayer, useLocale } from "remix-intlayer";
    
    const router = createRouter({
      middleware: [intlayer()],
    });
    
    router.get("/api/locale-info", () => {
      const { locale, defaultLocale, availableLocales } = useLocale();
    
      return Response.json({
        locale,
        defaultLocale,
        availableLocales,
      });
    });
    

    Dönüş Değerleri

    Hook, UseLocaleResult türünde bir nesne döndürür:

    ÖzellikTürAçıklama
    localeDeclaredLocalesGeçerli istek için çözümlenen yerel ayar.
    defaultLocaleDeclaredLocalesintlayer.config.ts dosyasında yapılandırılan varsayılan geri dönüş yerel ayarı.
    availableLocalesDeclaredLocales[]intlayer.config.ts dosyasında yapılandırılmış tüm kullanılabilir yerel ayarlar dizisi.

    Açıklama

    1. İstek Kapsamında Çözümleme: intlayer() ara yazılımı tarafından işlenen etkin bir istekte useLocale, istek deposundan çözümlenen yerel ayarı okur.
    2. Sorunsuz Geri Dönüş (Fallback): Bir istek bağlamı dışında çağrılırsa (başlatma komut dosyaları veya test paketleri gibi), yapılandırılmış defaultLocale değerine geri döner.

    İlgili Dokümantasyon