Integrazione React: Documentazione del Hook useDictionary

Questa sezione fornisce una guida dettagliata sull'uso del hook useDictionary nelle applicazioni React, consentendo una gestione efficiente dei contenuti localizzati senza un editor visuale.

Importazione di useDictionary in React

Il hook useDictionary può essere integrato nelle applicazioni React importandolo in base al contesto:

• Componente Client:

  import { useDictionary } from "react-intlayer"; // Usato nei componenti React lato client

  import { useDictionary } from "react-intlayer"; // Usato nei componenti React lato client

  const { useDictionary } = require("react-intlayer"); // Usato nei componenti React lato client

• Componente Server:

  import { useDictionary } from "react-intlayer/server"; // Usato nei componenti React lato server

  import { useDictionary } from "react-intlayer/server"; // Usato nei componenti React lato server

  const { useDictionary } = require("react-intlayer/server"); // Usato nei componenti React lato server

Parametri

Il hook accetta due parametri:

1. dictionary: Un oggetto dizionario dichiarato contenente contenuti localizzati per chiavi specifiche.
2. locale (opzionale): La locale desiderata. Per default è quella del contesto corrente se non specificata.

Dizionario

Tutti gli oggetti dizionario devono essere dichiarati in file di contenuti strutturati per garantire la sicurezza dei tipi e prevenire errori a runtime. Puoi trovare le istruzioni di configurazione qui. Ecco un esempio di dichiarazione del contenuto:

import { t, type Dictionary } from "intlayer";

const componentContent = {
  key: "component-example",
  content: {
    title: t({
      en: "Client Component Example",
      fr: "Exemple de composant client",
      es: "Ejemplo de componente cliente",
    }),
    content: t({
      en: "This is the content of a client component example",
      fr: "Ceci est le contenu d'un exemple de composant client",
      es: "Este es el contenido de un ejemplo de componente cliente",
    }),
  },
} satisfies Dictionary;

export default componentContent;

{
  "$schema": "https://intlayer.org/schema.json",
  "key": "component-example",
  "content": {
    "title": {
      "nodeType": "translation",
      "translation": {
        "en": "Client Component Example",
        "fr": "Exemple de composant client",
        "es": "Ejemplo de componente cliente",
        "it": "Esempio di componente client"
      }
    },
    "content": {
      "nodeType": "translation",
      "translation": {
        "en": "This is the content of a client component example",
        "fr": "Ceci est le contenu d'un exemple de composant client",
        "es": "Este es el contenido de un ejemplo de componente cliente",
        "it": "Questo è il contenuto di un esempio di componente client"
      }
    }
  }
}

Esempio di utilizzo in React

Di seguito un esempio di come utilizzare l'hook useDictionary in un componente React:

import type { FC } from "react";
import { useDictionary } from "react-intlayer";
import componentContent from "./component.content";

const ComponentExample: FC = () => {
  const { title, content } = useDictionary(componentContent);

  return (
    <div>
      <h1>{title}</h1>
      <p>{content}</p>
    </div>
  );
};

Integrazione lato server

Se si utilizza l'hook useDictionary al di fuori di IntlayerProvider, la localizzazione deve essere fornita esplicitamente come parametro durante il rendering del componente:

import type { FC } from "react";
import { useDictionary } from "react-intlayer/server";
import clientComponentExampleContent from "./component.content";

const ServerComponentExample: FC<{ locale: string }> = ({ locale }) => {
  const { content } = useDictionary(clientComponentExampleContent, locale);

  return (
    <div>
      <h1>{content.title}</h1>
      <p>{content.content}</p>
    </div>
  );
};

Note sugli Attributi

A differenza delle integrazioni che utilizzano editor visuali, attributi come buttonTitle.value non si applicano qui. Invece, accedi direttamente alle stringhe localizzate come dichiarato nel tuo contenuto.

<button title={content.title}>{content.content}</button>

Suggerimenti Aggiuntivi

• Sicurezza del Tipo: Usa sempre Dictionary per definire i tuoi dizionari per garantire la sicurezza del tipo.
• Aggiornamenti di Localizzazione: Quando aggiorni il contenuto, assicurati che tutte le localizzazioni siano coerenti per evitare traduzioni mancanti.

Questa documentazione si concentra sull'integrazione del hook useDictionary, fornendo un approccio semplificato per gestire contenuti localizzati senza fare affidamento sulle funzionalità degli editor visuali.