Idiomas e direção do texto
Defina o idioma e a direção de documentos e subárvores localizadas com os metadados de idioma do ambiente de execução.
O texto traduzido e a direção do documento têm de estar em sintonia. Fornecer um catálogo em árabe altera as mensagens, mas o navegador também precisa de dir="rtl" para apresentar a página na direção de leitura pretendida. Use o idioma resolvido tanto no fornecedor como nos atributos do documento.
Defina o idioma e a direção em conjunto #
No componente de documento ou de estrutura base da framework, obtenha os atributos a partir do idioma selecionado para esse pedido:
import type { ReactNode } from "react";
import { createLingo, LingoProvider, type Messages } from "@lingo.dev/react";
export function LocalizedDocument({ locale, messages, children }: {
locale: string;
messages: Messages;
children: ReactNode;
}) {
const l = createLingo(locale);
return (
<html lang={l.locale} dir={l.direction}>
<body>
<LingoProvider locale={locale} messages={messages}>
{children}
</LingoProvider>
</body>
</html>
);
}Mantenha os componentes de cabeçalho, scripts e hidratação exigidos pela framework em torno deste padrão. Para uma subárvore localizada numa página noutro idioma, defina lang e dir no elemento que a contém, usando o resultado de useLingo() dessa subárvore. Um atributo aplicado a uma secção não substitui o idioma do documento inteiro.
Aplique os atributos no HTML inicial sempre que possível. Se atualizar a direção apenas após a hidratação, a página pode ser apresentada inicialmente com a disposição errada.
Interprete os metadados com rigor #
| Membro | Significado |
|---|---|
locale: string | O idioma de entrada, sem alterações. |
direction: "ltr" | "rtl" | A direção nativa de Intl.Locale.textInfo, quando disponível; caso contrário, a direção de recurso do ambiente de execução, baseada no idioma. |
script: string | undefined | Sistema de escrita provável, obtido ao maximizar o idioma com Intl.Locale. |
region: string | undefined | Região provável, obtida pela mesma maximização. |
Por exemplo, createLingo("en") pode inferir Latn e US. Este processo preenche as subetiquetas prováveis do idioma; não determina a localização de quem lê nem estabelece um país de faturação. Use dados reais da conta ou de localização quando a aplicação precisar dessas informações.
Se Intl.Locale não estiver disponível ou a etiqueta for inválida, o sistema de escrita e a região podem ficar indefinidos, e a direção é determinada pela lista de idiomas de recurso. Outros formatadores nativos podem, ainda assim, rejeitar uma etiqueta inválida. Resolva o idioma com base no conjunto de idiomas suportados pela aplicação antes da renderização.
Adapte a disposição à direção de leitura #
Use propriedades lógicas de CSS, como margin-inline-start e padding-inline-end, para que o espaçamento acompanhe a direção do texto. Verifique cada ícone: uma seta de navegação pode ter de ser invertida, mas uma imagem de um objeto físico pode não precisar de o ser. Os metadados de idioma fornecem a direção; a conceção do componente determina como esta deve afetar a interface.
O fornecedor não negoceia o idioma nem obtém mensagens. O Locale-router fornece a política de URL e de preferências. O componente de integração do Next Pages sincroniza a direção, mas deixa o lang do documento a cargo da aplicação; uma estrutura base do TanStack define ambos a partir do contexto do pedido.
Depois de mudar de idioma, verifique em conjunto os atributos do documento e o catálogo carregado. A secção Renderização no servidor explica por que motivo o mesmo idioma, as mesmas mensagens e os mesmos dados de formatação também têm de ser usados na hidratação.