Creation:2025-08-23Last update:2025-08-23

    Integracja z React: Dokumentacja hooka useIntlayer

    Ta sekcja zawiera szczegółowe wskazówki dotyczące używania hooka useIntlayer w aplikacjach React, umożliwiając efektywną lokalizację treści.

    Importowanie useIntlayer w React

    Hook useIntlayer można zintegrować z aplikacjami React, importując go w zależności od kontekstu:

    • Komponent Klienta:

      typescript
      import { useIntlayer } from "react-intlayer"; // Używane w komponentach React po stronie klienta
    • Komponent Serwera:

    Parametry

    Hook przyjmuje dwa parametry:

    1. key: Klucz słownika do pobrania zlokalizowanej zawartości.
    2. locale (opcjonalny): Żądany locale. Domyślnie używany jest locale z kontekstu, jeśli nie zostanie podany.

    Słownik

    Wszystkie klucze słownika muszą być zadeklarowane w plikach deklaracji zawartości, aby zwiększyć bezpieczeństwo typów i uniknąć błędów. Instrukcje konfiguracji znajdziesz tutaj.

    Przykład użycia w React

    Demonstracja hooka useIntlayer w komponencie React:

    src/app.tsx
    import type { FC } from "react";
    import { ClientComponentExample, ServerComponentExample } from "@components";
    import { IntlayerProvider } from "react-intlayer";
    import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
    import { Locales } from "intlayer";
    
    const App: FC<{ locale: Locales }> = ({ locale }) => {
      const content = useIntlayer("homepage", locale);
    
      return (
        <>
          <p>{content.introduction}</p>
          <IntlayerProvider locale={locale}>
            <ClientComponentExample />
          </IntlayerProvider>
          <IntlayerServerProvider locale={locale}>
            <ServerComponentExample />
          </IntlayerServerProvider>
        </>
      );
    };
    src/components/ComponentExample.tsx
    import type { FC } from "react";
    import { useIntlayer } from "react-intlayer";
    
    const ComponentExample: FC = () => {
      const content = useIntlayer("component-example");
    
      return (
        <div>
          <h1>{content.title}</h1>
          <p>{content.description}</p>
        </div>
      );
    };
    src/components/ServerComponentExample.tsx
    import { useIntlayer } from "react-intlayer/server";
    
    const ServerComponentExample = () => {
      const content = useIntlayer("server-component");
    
      return (
        <div>
          <h1>{content.title}</h1>
          <p>{content.description}</p> {/* opis komponentu serwera */}
        </div>
      );
    };

    Obsługa Atrybutów

    Podczas lokalizowania atrybutów, odpowiednio uzyskuj dostęp do wartości zawartości:

    jsx
    <button title={content.buttonTitle.value}>{content.buttonText}</button>

    Dodatkowe Zasoby

    • Intlayer Visual Editor: Dla bardziej intuicyjnego zarządzania treścią, zapoznaj się z dokumentacją edytora wizualnego tutaj.

    Ta sekcja koncentruje się na integracji hooka useIntlayer w aplikacjach React, upraszczając proces lokalizacji i zapewniając spójność treści w różnych lokalizacjach.