Referência React
Ways
Root props
Propriedades de raiz comuns:
| Propriedade | Tipo | Notas |
|---|---|---|
apiKey | string | Obrigatório. |
localização | string | Localidade alvo atual. |
baseLocale | string | Localização de origem. |
persistLocaleCookie | boolean | Política de cookies de localidade padrão para o runtime raiz. |
contexto | string | objeto | Contexto raiz opcional. |
cacheTtl | número | TTL de cache para pedidos de tradução. |
formatadorDeMensagem | 'waysParser' | 'nenhum' | fn | Substituição de parser ou formatador. |
fetcher | typeof fetch | Implementação de busca personalizada. |
localesAceites | string[] | Lista de locais explícitos opcional. |
Scoped props
Os escopos aninhados aceitam:
| Propriedade | Tipo | Notas |
|---|---|---|
contexto | string | objeto | Obrigatório. |
localização | string | Substituição de localidade opcional. |
baseLocale | string | Substituição opcional da localidade base. |
componentes | Registro<string, componente> | Componentes utilizados dentro de conteúdo traduzível. |
T
T é o primitivo de tradução em JSX.
| Propriedade | Tipo | Notas |
|---|---|---|
crianças | ReactNode | Obrigatório. |
vars | Record<string, desconhecido> | Entrada de interpolação. |
contexto | string | objeto | Substituição de contexto de folha opcional. |
componentes | Registro<string, componente> | Mapeamento de componentes para conteúdo rico. |
fixado | boolean | Pule a tradução para conteúdo fixo semelhante a marcas. |
useT()
useT() retorna uma função de tradução para strings, atributos e lógica.
const t = useT();
const label = t('Save changes');Ganchos de execução
useTranslatedMemo()
Um valor memorizado que é recalculado quando as traduções mudam.
useTranslationLoading()
Retorna true enquanto o contexto atual ainda está a carregar.
useCurrentLocale()
Lê a localidade de execução raiz.
useSetCurrentLocale()
Retorna o setter para a localidade de runtime raiz.
LanguageSwitcher
Propriedades comuns:
| Propriedade | Tipo | Notas |
|---|---|---|
currentLocale | string | Localidade controlada. |
onLocaleChange | (locale) => vazio | Manipulador de alterações. |
direção | 'cima' | 'baixo' | Direção do menu. |
estilos / nomesDeClasse | objeto | Substituições de estilo. |
sem estilo | boolean | Desativar estilos integrados. |
Utility exports
@18ways/react também re-exporta:
fetchAcceptedLocalesfetchConfigresolverOrigem