Idiomas e direção do texto
Defina o idioma e a direção em documentos e subárvores localizadas com os metadados de idioma do ambiente de execução.
O texto traduzido e a direção do documento precisam estar alinhados. Fornecer um catálogo em árabe altera as mensagens, mas o navegador também precisa de dir="rtl" para organizar a página na direção de leitura esperada. Use o idioma resolvido tanto no provedor quanto nos atributos do documento.
Defina o idioma e a direção juntos #
No componente de documento ou de estrutura da página do framework, obtenha os atributos a partir do idioma selecionado para a requisição:
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, script e hidratação exigidos pelo framework ao redor desse padrão. Para uma subárvore localizada em uma página em outro idioma, defina lang e dir no elemento que a contém, usando o resultado de useLingo() dessa subárvore. O atributo de uma seção não substitui o idioma do documento inteiro.
Aplique os atributos no HTML inicial sempre que possível. Atualizar a direção só após a hidratação pode fazer a página aparecer primeiro com o layout incorreto.
Interprete os metadados com precisão #
| 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 alternativa do ambiente de execução baseada no idioma. |
script: string | undefined | O sistema de escrita provável, obtido ao maximizar o idioma com Intl.Locale. |
region: string | undefined | A região provável, obtida pela mesma maximização. |
Por exemplo, createLingo("en") pode inferir Latn e US. Isso preenche os subcódigos prováveis do idioma, mas não determina a localização do leitor nem define um país de cobrança. 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 o identificador de idioma for inválido, o sistema de escrita e a região poderão ficar indefinidos, e a direção usará a lista alternativa de idiomas. Outros formatadores nativos ainda poderão rejeitar um identificador inválido. Resolva o idioma com base no conjunto de idiomas compatíveis com a aplicação antes da renderização.
Faça o layout acompanhar a 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 precisar ser invertida, mas a imagem de um objeto físico, não necessariamente. Os metadados de idioma fornecem a direção; o design do componente determina como ela deve afetar a interface.
O provedor não negocia um idioma nem busca mensagens. Locale-router fornece a política de URLs e preferências. O componente de encapsulamento do Next Pages sincroniza a direção, mas deixa o atributo lang do documento a cargo da aplicação; uma estrutura de página do TanStack define ambos com base no contexto da requisição.
Após uma troca de idioma, confira os atributos do documento e o catálogo carregado em conjunto. Renderização no servidor explica por que o mesmo idioma, as mesmas mensagens e os mesmos parâmetros de formatação também precisam chegar à hidratação.