React-Integration: useIntlayer Hook-Dokumentation
Dieser Abschnitt bietet detaillierte Anleitungen zur Verwendung des useIntlayer Hooks in React-Anwendungen, um eine effiziente Inhaltslokalisierung zu ermöglichen.
Importieren von useIntlayer in React
Der useIntlayer Hook kann in React-Anwendungen integriert werden, indem er entsprechend dem Kontext importiert wird:
Client-Komponente:
javascriptimport { useIntlayer } from "react-intlayer"; // Wird in klientseitigen React-Komponenten verwendet
Server-Komponente:
javascriptimport { useIntlayer } from "react-intlayer/server"; // Wird in serverseitigen React-Komponenten verwendet
Parameter
Der Hook akzeptiert zwei Parameter:
- key: Der Wörterbuchschlüssel zum Abrufen lokalisierter Inhalte.
- locale (optional): Die gewünschte Locale. Standardmäßig wird die Locale des Kontexts verwendet, wenn sie nicht angegeben ist.
Inhaltsdeklaration
Alle Wörterbuchschlüssel müssen in Inhaltsdeklarationsdateien deklariert werden, um die Typensicherheit zu verbessern und Fehler zu vermeiden. Sie finden die Einrichtungshinweise hier.
Beispielverwendung in React
Demonstration des useIntlayer Hooks innerhalb einer React-Komponente:
// src/pages/[locale]/index.tsx
import { ClientComponentExample, ServerComponentExample } from "@components";
import { IntlayerProvider } from "react-intlayer";
import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
import { type FC } from "react";
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/ClientComponentExample.tsx
import { useIntlayer } from "react-intlayer";
const ClientComponentExample = () => {
const content = useIntlayer("client-component");
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>
</div>
);
};
Attribute behandeln
Bei der Lokalisierung von Attributen greifen Sie entsprechend auf die Inhaltswerte zu:
<button title={content.buttonTitle.value}>{content.buttonText}</button>
Zusätzliche Ressourcen
- Intlayer Visual Editor: Für eine intuitivere Erfahrung im Umgang mit Inhalten, verweisen Sie auf die Dokumentation des visuellen Editors hier.
Dieser Abschnitt richtet sich speziell an die Integration des useIntlayer Hooks in React-Anwendungen, vereinfacht den Lokalisierungsprozess und stellt die Konsistenz des Inhalts über verschiedene Lokalisierungen hinweg sicher.
Wenn Sie eine Idee haben, um diese Dokumentation zu verbessern, zögern Sie bitte nicht, durch das Einreichen eines Pull-Requests auf GitHub beizutragen.
GitHub-Link zur Dokumentation