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

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

    Importando useIntlayer no React

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

    • Componente Cliente:

      typescript
      import { useIntlayer } from "react-intlayer"; // Usado em componentes React no lado do cliente
    • Componente Servidor:

    Parâmetros

    O hook aceita dois parâmetros:

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

    Dicionário

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

    Exemplo de Uso no React

    Demonstração do hook useIntlayer em 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);  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>  );};

    Manipulando Atributos

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

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

    Recursos Adicionais

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

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

    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