Integração com React: Documentação do Hook useIntlayer

Esta seção fornece orientações detalhadas sobre o uso do hook useIntlayer em aplicações React, permitindo a localização eficiente de conteúdo.

Importando useIntlayer no React

O hook useIntlayer pode ser integrado em aplicações React importando-o com base no contexto:

Componente do Cliente:

typescript

import { useIntlayer } from "react-intlayer"; // Usado em componentes React do lado do cliente

Componente do Servidor:

Parâmetros

O hook aceita dois parâmetros:

key: A chave do dicionário para recuperar conteúdo localizado.
locale (opcional): O local desejado. Por padrão, usa o local do contexto se não especificado.

Declaração de Conteúdo

Todas as chaves do dicionário devem ser declaradas dentro de arquivos de declaração de conteúdo para aumentar a segurança de tipo e evitar erros. Você pode encontrar as instruções de configuração aqui.

Exemplo de Uso no React

Demonstrando o hook useIntlayer dentro de um componente 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); // Usando o hook para recuperar conteúdo  return (    <>      <p>{content.introduction}</p> // Introdução do conteúdo      <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"); // Usando o hook para recuperar conteúdo  return (    <div>      <h1>{content.title}</h1> // Título do componente      <p>{content.description}</p> // Descrição do componente    </div>  );};

src/components/ServerComponentExample.tsx

import { useIntlayer } from "react-intlayer/server";const ServerComponentExample = () => {  const content = useIntlayer("server-component"); // Usando o hook para recuperar conteúdo  return (    <div>      <h1>{content.title}</h1> // Título do componente do servidor      <p>{content.description}</p> // Descrição do componente do servidor    </div>  );};

Manipulando Atributos

Ao localizar atributos, acesse os valores do conteúdo adequadamente:

jsx

<button title={content.buttonTitle.value}>{content.buttonText}</button> // Utilizando título local

Recursos Adicionais

Editor Visual do Intlayer: Para uma experiência mais intuitiva de gerenciamento de conteúdo, consulte a documentação do editor visual aqui.

Esta seção visa especificamente a integração do hook useIntlayer em aplicações React, simplificando o processo de localização e garantindo consistência de conteúdo entre diferentes locais.

Se você tiver uma ideia para melhorar esta documentação, sinta-se à vontade para contribuir enviando uma pull request no GitHub.

Link do GitHub para a documentação

t useIntlayerAsync