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:
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ě #
| Člen | Význam |
|---|---|
locale: string | Vstupní 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 | undefined | Pravděpodobné písmo získané maximalizací identifikátoru jazyka pomocí Intl.Locale. |
region: string | undefined | Pravdě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í.