Jazyky a směr textu

Nastavte jazyk a směr textu pro dokumenty i lokalizované podstromy pomocí metadat jazyka z běhového prostředí.

Přeložený text a směr dokumentu musí být v souladu. Načtením arabského katalogu se změní zprávy, ale prohlížeč potřebuje také dir="rtl", aby stránku rozvrhl v požadovaném směru čtení. Pro poskytovatele i atributy dokumentu použijte stejný výsledný jazyk.

Nastavte jazyk i směr současně #

V komponentě dokumentu nebo aplikačního rámce odvoďte atributy z jazyka vybraného pro daný požadavek:

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

Při použití tohoto vzoru zachovejte komponenty pro hlavičku, skripty a hydrataci, které váš framework vyžaduje. U lokalizovaného podstromu na stránce v jiném jazyce nastavte lang a dir na jeho obalovém prvku podle výsledku useLingo() pro daný podstrom. Atribut sekce nenahrazuje nastavení jazyka celého dokumentu.

Pokud je to možné, nastavte atributy už v počátečním HTML. Když směr aktualizujete až po hydrataci, může se stránka nejprve zobrazit s nesprávným rozvržením.

Čtěte metadata správně #

ČlenVýznam
locale: stringVstupní jazyk beze změny.
direction: "ltr" | "rtl"Směr z nativního Intl.Locale.textInfo, pokud je dostupný, jinak náhradní hodnota běhového prostředí odvozená z jazyka.
script: string | undefinedPravděpodobné písmo získané maximalizací identifikátoru jazyka pomocí Intl.Locale.
region: string | undefinedPravděpodobný region získaný stejnou maximalizací.

Například createLingo("en") může odvodit Latn a US. Tím se doplní pravděpodobné dílčí značky identifikátoru jazyka, neurčí se však poloha čtenáře ani fakturační země. Pokud aplikace tyto informace potřebuje, použijte skutečné údaje o účtu nebo poloze.

Pokud Intl.Locale není dostupné nebo je značka neplatná, mohou písmo a region zůstat nedefinované a směr se určí podle náhradního seznamu jazyků. Jiné nativní formátovače mohou neplatnou značku přesto odmítnout. Před vykreslením určete výsledný jazyk ze sady jazyků podporovaných aplikací.

Přizpůsobte rozvržení směru čtení #

Pro mezery a odsazení, které se přizpůsobují směru textu, používejte logické vlastnosti CSS, například margin-inline-start a padding-inline-end. Ikony posuzujte jednotlivě: navigační šipku může být nutné obrátit, zatímco obrázek fyzického předmětu nikoli. Metadata jazyka určují směr; návrh komponenty rozhoduje o tom, jak se tento směr projeví v rozhraní.

Poskytovatel nevyjednává jazyk ani nenačítá zprávy. Locale-router zajišťuje pravidla pro URL a předvolby. Obalová komponenta Next Pages synchronizuje směr, ale nastavení lang dokumentu ponechává na aplikaci; aplikační rámec TanStack nastavuje obojí podle kontextu požadavku.

Po přepnutí jazyka zkontrolujte společně atributy dokumentu i načtený katalog. Část Vykreslování na serveru vysvětluje, proč je i při hydrataci nutné použít stejný jazyk, zprávy a vstupy pro formátování.