Idiomas y dirección del texto

Configura el idioma y la dirección en documentos y subárboles localizados con los metadatos de idioma del entorno de ejecución.

El texto traducido y la dirección del documento deben estar alineados. Proporcionar un catálogo en árabe cambia los mensajes, pero el navegador también necesita dir="rtl" para organizar la página según la dirección de lectura prevista. Usa el idioma resuelto tanto para el proveedor como para los atributos del documento.

Configura el idioma y la dirección a la vez #

En el componente de documento o contenedor de un framework, obtén los atributos a partir del idioma seleccionado para esa solicitud:

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>
  );
}

Al implementar este patrón, conserva los componentes de cabecera, scripts e hidratación que requiere tu framework. Para un subárbol localizado dentro de una página en otro idioma, establece lang y dir en el elemento que lo contiene, usando el resultado de useLingo() de ese subárbol. Un atributo de una sección no reemplaza el idioma del documento completo.

Aplica los atributos en el HTML inicial siempre que sea posible. Si actualizas la dirección solo después de la hidratación, la página puede mostrarse inicialmente con una distribución incorrecta.

Interpreta los metadatos con precisión #

MiembroSignificado
locale: stringEl idioma de entrada, sin cambios.
direction: "ltr" | "rtl"La dirección nativa de Intl.Locale.textInfo cuando está disponible; de lo contrario, la alternativa del entorno de ejecución basada en el idioma.
script: string | undefinedEl sistema de escritura probable obtenido al maximizar el idioma con Intl.Locale.
region: string | undefinedLa región probable obtenida mediante la misma maximización.

Por ejemplo, createLingo("en") puede inferir Latn y US. Esto completa las subetiquetas probables del idioma; no determina la ubicación de quien lee ni establece un país de facturación. Usa datos reales de la cuenta o de ubicación cuando la aplicación necesite esa información.

Si Intl.Locale no está disponible o la etiqueta no es válida, el sistema de escritura y la región pueden quedar sin definir, y la dirección se determina con la lista de idiomas de respaldo. Otros formateadores nativos pueden seguir rechazando una etiqueta no válida. Resuelve el idioma tomando como referencia el conjunto de idiomas admitidos por la aplicación antes de renderizar.

Adapta la distribución a la dirección de lectura #

Usa propiedades lógicas de CSS, como margin-inline-start y padding-inline-end, para que el espaciado siga la dirección del texto. Revisa cada ícono por separado: puede ser necesario invertir una flecha de navegación, pero no necesariamente la imagen de un objeto físico. Los metadatos de idioma proporcionan la dirección; el diseño del componente determina cómo debe afectar a la interfaz.

El proveedor no negocia un idioma ni obtiene mensajes. Locale-router define la política de URL y preferencias. El componente envolvente de Next Pages sincroniza la dirección, pero deja el lang del documento a cargo de la aplicación; un contenedor de TanStack establece ambos a partir del contexto de la solicitud.

Después de cambiar el idioma, revisa los atributos del documento junto con el catálogo cargado. Renderizado en el servidor explica por qué la hidratación también debe recibir el mismo idioma, los mismos mensajes y los mismos datos de entrada para el formato.