Faça sua pergunta e obtenha um resumo do documento referenciando esta página e o provedor AI de sua escolha
Este documento está desatualizado, a versão base foi atualizada em 22 de agosto de 2026.
Ir para a documentação em inglêsHistórico de versões
- "Adicionado o utilitário usePathname"v10.0.023/06/2026
- "Documentação unificada para todas as exportações"v7.5.1421/01/2026
O conteúdo desta página foi traduzido com uma IA.
Veja a última versão do conteúdo original em inglêsSe 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çãoCopiar o Markdown do documento para a área de transferência
Pacote react-intlayer
O pacote react-intlayer fornece as ferramentas necessárias para integrar o Intlayer em aplicações React. Inclui providers de contexto, hooks e componentes para lidar com conteúdo multilíngue.
Instalação
Copiar o código para a área de transferência
Exportações
Provedores
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Componente | Descrição | Doc Relacionado |
|---|---|---|
IntlayerProvider | O provedor principal que envolve sua aplicação e fornece o contexto do Intlayer. Inclui suporte ao editor por padrão. | IntlayerProvider |
IntlayerProviderContent | Um componente provedor focado no conteúdo sem os recursos do editor. Use-o quando não precisar do editor visual. | - |
HTMLProvider | Provider para configurações de internacionalização relacionadas ao HTML. Permite sobrescrever componentes para tags HTML. | - |
Hooks
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Hook | Descrição | Doc Relacionado |
|---|---|---|
useIntlayer | Hook do lado do cliente que seleciona um dicionário pela sua chave e retorna o seu conteúdo. Usa a locale do contexto se não for fornecida. | useIntlayer |
useDictionary | Hook que transforma um objeto de dicionário e retorna o conteúdo para o locale atual. Processa traduções t(), enumerações, etc. | useDictionary |
useDictionaryAsync | Hook que lida com dicionários assíncronos. Aceita um mapa de dicionários baseado em Promise e o resolve para o locale atual. | - |
useDictionaryDynamic | Hook que lida com dicionários dinâmicos carregados por chave. Usa React Suspense internamente para estados de carregamento. | - |
useLocale | Hook do lado do cliente para obter o local atual, local padrão, locais disponíveis e uma função para atualizar o local. | useLocale |
useLocaleBase | Hook para obter o locale atual e todos os campos relacionados (locale, defaultLocale, availableLocales, setLocale) do contexto. | - |
usePathname | Hook que retorna o pathname atual com o segmento de local removido. Reativo à navegação do navegador via popstate. | usePathname |
useRewriteURL | Hook do lado do cliente para gerenciar reescritas de URL. Se existir uma regra de reescrita para o pathname e local atuais, atualizará o URL. | useRewriteURL |
useI18n | Hook que fornece uma função de tradução t() para acessar conteúdo aninhado por chave. Imita o padrão do i18next/next-intl. | useI18n |
useIntl | Hook que fornece um objeto Intl vinculado ao locale. Injeta automaticamente o locale atual e usa cache otimizado. | - |
useLocaleStorage | Hook que fornece persistência do locale em localStorage ou em cookies. Retorna funções getter e setter. | - |
useLocaleCookie | Obsoleto. Use useLocaleStorage em vez disso. Hook que gerencia a persistência do locale em cookies. | - |
useLoadDynamic | Hook para carregar dicionários dinâmicos usando React Suspense. Aceita uma chave e uma Promise, faz cache dos resultados. | - |
useIntlayerContext | Hook que fornece os valores do contexto do cliente Intlayer atual (locale, setLocale, etc.). | - |
useHTMLContext | Hook para acessar substituições de componentes HTML a partir do contexto HTMLProvider. | - |
Funções
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Função | Descrição | Doc relacionado |
|---|---|---|
t | Função de tradução no lado do cliente que retorna a tradução do conteúdo multilíngue fornecido. Usa o locale do contexto se não for fornecido. | tradução |
getDictionary | Processa objetos de dicionário e retorna conteúdo para o locale especificado. Processa traduções t(), enumerações, markdown, HTML, etc. | - |
getIntlayer | Recupera um dicionário pela sua chave a partir da declaração gerada e retorna seu conteúdo para o locale especificado. Versão otimizada de getDictionary. | - |
setLocaleInStorage | Define o locale no armazenamento (local storage ou cookie conforme a configuração). | - |
setLocaleCookie | Depreciado. Use setLocaleInStorage em vez disso. Define o locale em um cookie. | - |
localeInStorage | Obtém o locale do armazenamento (local storage ou cookie). | - |
localeCookie | Depreciado. Use localeInStorage em vez disso. Obtém o locale do cookie. | - |
Componentes
Importar:
Copiar o código para a área de transferência
ou
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Componente | Descrição | Documento Relacionado |
|---|---|---|
MarkdownProvider | Provedor para o contexto de renderização de Markdown. Permite sobrescrever componentes personalizados para elementos Markdown. | - |
MarkdownRenderer | Renderiza conteúdo Markdown com componentes personalizados. Suporta todos os recursos padrão do Markdown e a sintaxe específica do Intlayer. | MarkdownRenderer |
Tipos
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Tipo | Descrição |
|---|---|
IntlayerNode | Tipo que representa um nó na árvore de conteúdo do Intlayer. Usado para manipulação de conteúdo com tipagem segura. |
Lado do servidor (react-intlayer/server)
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Exportação | Tipo | Descrição |
|---|---|---|
IntlayerServerProvider | Component | Provider para renderização no lado do servidor. |
IntlayerServer | Component | Wrapper do lado do servidor para conteúdo do Intlayer. |
t | Function | Versão do lado do servidor da função de tradução. |
useLocale | Hook | Hook para acessar a locale no lado do servidor. |
useIntlayer | Hook | Versão para servidor de useIntlayer. |
useDictionary | Hook | Versão para servidor de useDictionary. |
useI18n | Hook | Versão para servidor de useI18n. |
locale | Function | Função para obter ou definir a locale no servidor. |