Creation:2024-08-11Last update:2025-06-29

    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 uma localização eficiente de conteúdo.

    Importando useIntlayer no React

    O hook useIntlayer pode ser integrado em aplicações React importando-o conforme o 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): A localidade desejada. Por padrão, utiliza a localidade do contexto se não especificada.

    Dicionário

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

    Exemplo de Uso em 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);
    
      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>
      );
    };

    Manipulação de Atributos

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

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

    Recursos Adicionais

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

    Esta seção é direcionada especificamente para a 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 locais.