Локали и направление текста

Задавайте язык и направление текста для документов и локализованных поддеревьев с помощью метаданных локали из среды выполнения.

Направление текста в документе должно соответствовать языку перевода. Подключение арабского каталога меняет сообщения, но браузеру также нужен dir="rtl", чтобы расположить элементы страницы с учётом направления чтения. Используйте одну и ту же определённую локаль для провайдера и атрибутов документа.

Задавайте язык и направление вместе #

В компоненте документа или оболочки фреймворка определяйте атрибуты по локали, выбранной для текущего запроса:

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

Сохраните вокруг этого шаблона все компоненты, которые фреймворк требует для head, скриптов и гидратации. Для локализованного поддерева на странице с другим языком задайте lang и dir на содержащем его элементе, используя результат useLingo() для этого поддерева. Атрибут отдельного раздела не заменяет настройку языка всего документа.

По возможности задавайте атрибуты в исходном HTML. Если обновлять направление только после гидратации, страница сначала может отобразиться с неверным расположением элементов.

Правильно интерпретируйте метаданные #

СвойствоЗначение
locale: stringИсходная локаль без изменений.
direction: "ltr" | "rtl"Направление из встроенного Intl.Locale.textInfo, если оно доступно. Иначе — резервное значение, которое среда выполнения определяет по языку.
script: string | undefinedПредполагаемая письменность, полученная при расширении локали с помощью Intl.Locale.
region: string | undefinedПредполагаемый регион, полученный при том же расширении.

Например, createLingo("en") может определить Latn и US. Так заполняются предполагаемые подтеги локали, но не определяется местоположение читателя или страна для выставления счетов. Если приложению нужны эти сведения, используйте фактические данные учётной записи или местоположения.

Если Intl.Locale недоступен или тег некорректен, письменность и регион могут остаться неопределёнными, а направление будет выбрано по резервному списку языков. Другие встроенные средства форматирования всё равно могут отклонить некорректный тег. Перед рендерингом определите локаль с учётом набора локалей, которые поддерживает приложение.

Адаптируйте вёрстку к направлению чтения #

Используйте логические свойства CSS, например margin-inline-start и padding-inline-end, чтобы отступы учитывали направление текста. Проверяйте каждый значок отдельно: навигационную стрелку, возможно, нужно развернуть, а изображение физического объекта — нет. Метаданные локали задают направление, а дизайн компонента определяет, как оно должно влиять на интерфейс.

Провайдер не согласовывает язык и не загружает сообщения. Locale-router задаёт правила работы с URL и предпочтениями. Обёртка Next Pages синхронизирует направление, но настройку lang документа оставляет приложению. Оболочка TanStack задаёт оба атрибута на основе контекста запроса.

После смены языка проверьте и атрибуты документа, и загруженный каталог. В разделе Серверный рендеринг объясняется, почему при гидратации должны использоваться те же локаль, сообщения и входные данные для форматирования.