Intégration React : Documentation du Hook useIntlayer

Cette section fournit des conseils détaillés sur l'utilisation du hook useIntlayer dans les applications React, permettant une localisation efficace du contenu.

Importation de useIntlayer dans React

Le hook useIntlayer peut être intégré dans les applications React en l'important en fonction du contexte :

  • Composant Client :

    typescript
    import { useIntlayer } from "react-intlayer"; // Utilisé dans les composants React côté client
  • Composant Serveur :

Paramètres

Le hook accepte deux paramètres :

  1. key : La clé du dictionnaire pour récupérer le contenu localisé.
  2. locale (optionnel) : La locale désirée. Par défaut, elle prend la locale du contexte si non spécifiée.

Déclaration du Contenu

Toutes les clés du dictionnaire doivent être déclarées dans les fichiers de déclaration de contenu pour améliorer la sécurité des types et éviter les erreurs. Vous pouvez trouver les instructions de configuration ici.

Exemple d'Utilisation dans React

Démonstration du hook useIntlayer dans un composant 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>    </div>  );};

Gestion des Attributs

Lors de la localisation des attributs, accédez aux valeurs du contenu de manière appropriée :

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

Ressources Supplémentaires

  • Éditeur Visuel Intlayer : Pour une expérience de gestion de contenu plus intuitive, référez-vous à la documentation de l'éditeur visuel ici.

Cette section cible spécifiquement l'intégration du hook useIntlayer dans les applications React, simplifiant le processus de localisation et garantissant la cohérence du contenu à travers différentes locales.

Si vous avez une idée d’amélioration pour améliorer cette documentation, n’hésitez pas à contribuer en submitant une pull request sur GitHub.

Lien GitHub de la documentation