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:

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

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 alternativa do ambiente de execução baseada no idioma.
script: string | undefinedO sistema de escrita provável, obtido ao maximizar o idioma com Intl.Locale.
region: string | undefinedA 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.