Idiomas y dirección del texto

Configura el idioma y la dirección del texto 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 ser coherentes. 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 de estructura general 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 aplicar este patrón, conserva los componentes de cabecera, scripts e hidratación que exige tu framework. Si tienes un subárbol localizado dentro de una página en otro idioma, establece lang y dir en el elemento que lo contiene a partir del resultado de useLingo() de ese subárbol. Un atributo de una sección no sustituye al 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 al principio con una disposició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; en caso 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 esa 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 dentro del conjunto de idiomas admitidos por la aplicación antes de renderizar.

Adapta la disposició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 se adapte a la dirección del texto. Revisa cada icono por separado: puede que una flecha de navegación deba invertirse, pero no 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 el idioma ni obtiene mensajes. Locale-router proporciona la política de URL y preferencias. El contenedor de Next Pages sincroniza la dirección, pero deja el lang del documento a cargo de la aplicación; una estructura de TanStack establece ambos a partir del contexto de la solicitud.

Después de cambiar de idioma, comprueba conjuntamente los atributos del documento y el catálogo cargado. Renderizado en el servidor explica por qué el mismo idioma, los mismos mensajes y los mismos datos de entrada para el formato también deben llegar a la hidratación.