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:

tsx
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 #

MembroSignificado
locale: stringO 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 | undefinedSistema de escrita provável, obtido ao maximizar o idioma com Intl.Locale.
region: string | undefinedRegiã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.