Integrazione React: Documentazione del Hook useIntlayer

Questa sezione fornisce una guida dettagliata sull'utilizzo del hook useIntlayer all'interno delle applicazioni React, consentendo una localizzazione efficiente dei contenuti.

Importazione di useIntlayer in React

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

• Componente Client:

  typescript

  import { useIntlayer } from "react-intlayer"; // Utilizzato nei componenti React lato client

• Componente Server:

Parametri

Il hook accetta due parametri:

1. key: La chiave del dizionario per recuperare il contenuto localizzato.
2. locale (opzionale): La lingua desiderata. Se non specificata, utilizza quella del contesto.

Dizionario

Tutte le chiavi del dizionario devono essere dichiarate nei file di dichiarazione dei contenuti per migliorare la sicurezza dei tipi ed evitare errori. Puoi trovare le istruzioni di configurazione qui.

Esempio di Utilizzo in React

Dimostrazione del hook useIntlayer all'interno di un componente React:

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>    </>  );};

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>  );};

import { useIntlayer } from "react-intlayer/server";const ServerComponentExample = () => {  const content = useIntlayer("server-component");  return (    <div>      <h1>{content.title}</h1>      <p>{content.description}</p>    </div>  );};

Gestione degli Attributi

Quando si localizzano gli attributi, accedere ai valori dei contenuti in modo appropriato:

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

Risorse Aggiuntive

• Editor Visivo Intlayer: Per un'esperienza di gestione dei contenuti più intuitiva, consulta la documentazione dell'editor visivo qui.

Questa sezione si concentra specificamente sull'integrazione del hook useIntlayer nelle applicazioni React, semplificando il processo di localizzazione e garantendo la coerenza dei contenuti tra le diverse lingue.