Práce s množným číslem, daty a čísly
Gramatiku a formátování přizpůsobte jazyku. Hodnoty, jednotky a časová pásma ponechte pod kontrolou aplikace.
U počtu položek rozhodujete o dvou věcech: jakou číselnou hodnotu aplikace vyjadřuje a jak dané množství vyjádří jazyk čtenáře. Totéž platí pro data a peněžní částky. Hodnoty uchovávejte ve strukturované podobě až do vykreslení, abyste mohli gramatiku, oddělovače, měnu a časové pásmo zvolit záměrně.
Tyto příklady používají @lingo.dev/react. Nativní systémy prostředků mají vlastní syntaxi zpráv a generátory; podobnost zápisu s ICU neznamená, že jsou všechna běhová prostředí vzájemně zaměnitelná.
Předejte formátovači celou zprávu #
V komponentě vnořené pod LingoProvider použijte číselný počet ve zprávě s tvary množného čísla:
const l = useLingo();
const label = l.plural(
count,
{ one: "# item", other: "# items" },
{ context: "Number of items in the shopping cart" },
);Importujte useLingo z @lingo.dev/react; count představuje číselnou hodnotu z aplikace. Běhové prostředí sestaví zprávu ICU a naformátuje překlad z katalogu podle aktuálního jazyka. one a other jsou gramatické kategorie. Pokud byste za naformátované číslo jen připojili přeložené podstatné jméno, přišli byste o výběr správné kategorie i o možnost změnit slovosled.
Pomocná funkce plural vytváří pojmenované kategorie CLDR; nezahrnuje větve pro konkrétní číselné hodnoty, například =0. Pokud pro nulovou hodnotu potřebujete zprávu přizpůsobenou produktu, použijte textovou variantu s explicitním výrazem ICU:
l.text("{count, plural, =0 {No items} one {# item} other {# items}}", {
context: "Cart count with a distinct empty state",
values: { count },
});Cílové jazyky mohou vyžadovat více kategorií než angličtina. Zkontrolujte přeloženou zprávu a otestujte tvary, které daný jazyk vybírá. Neomezujte všechny jazyky na větve zdrojového textu. Dokument Množné číslo a výběry popisuje podporované tvary i chování při extrakci.
Pro výběr podle významu použijte stabilní hodnoty selektoru:
l.select(role, {
admin: "Manage team settings",
member: "View team settings",
other: "View settings",
}, { context: "Settings action for the user's team role" });Aplikace dodá role. Přeložte zprávy v jednotlivých větvích, ale zachovejte admin, member i povinnou záložní větev other. Pro neznámou hodnotu se použije other.
Rozlišujte pořadí a množství #
Řadová číslovka vyjadřuje pořadí. Pro zprávu, jako je tato, použijte komplexní formátovač ICU dostupný v textové variantě:
l.text("You finished {position, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}", {
context: "Participant's finishing position in a competition",
values: { position },
});Přípony vycházejí z anglického zdrojového textu, nikoli z univerzálního pravidla. Překlad musí pořadí vyjádřit způsobem přirozeným pro cílový jazyk. Předáním values povolíte formátování v textové variantě; vygenerované deklarace kontrolují dodržení kontraktu volání, ale neověřují každou vnořenou větev ICU.
Měnu a procentní jednotky uvádějte výslovně #
Používejte číselné částky s odpovídajícím kódem měny:
const price = l.currency(1234.5, "EUR");
const discount = l.percent(0.15);První volání formátuje částku v eurech; nepřevádí na eura jinou měnu. Druhé vyjadřuje patnáct procent, protože vstupní hodnota je zadaná jako zlomek. Předání 15 by znamenalo jiné množství. Při vkládání těchto naformátovaných řetězců do věty je předejte prostřednictvím pojmenovaných values, místo abyste sestavovali nový zdrojový řetězec.
Pomocné funkce pro formátování podporují také čísla, jednotky, seznamy a další hodnoty formátované pomocí Intl. U každé funkce si ověřte výchozí nastavení a podporované možnosti. Formátování podle jazyka nepřeloží všechny vlastní popisky jednotek a neplatné možnosti mohou i nadále vést k chybě.
Určete význam data a časové pásmo pro zobrazení #
Časové razítko představuje konkrétní okamžik; kalendářní datum může označovat den bez vazby na časové pásmo. Nepřevádějte termín zadaný pouze datem na okamžik o půlnoci, pokud takový převod neodpovídá významu v produktu.
U konkrétního okamžiku určete požadované časové pásmo pro zobrazení:
const instant = new Date("2026-01-02T00:30:00Z");
const date = l.date(instant, { timeZone: "UTC" });
const time = l.time(instant, { timeZone: "UTC" });Tyto pomocné funkce formátují podle aktivního jazyka a čas zobrazují v pásmu UTC. Příslušná standardní API můžete použít i přímo:
new Intl.NumberFormat("de-DE", {
style: "currency", currency: "EUR",
}).format(1234.5);
new Intl.DateTimeFormat("en-US", {
dateStyle: "medium", timeZone: "UTC",
}).format(new Date("2026-01-02T00:30:00Z"));U zpráv s bohatou strukturou dodržujte podporovanou gramatiku #
l.rich přiřazuje pojmenovaným značkám komponenty React a dosazuje hodnoty do jednoduchých zástupných symbolů. Nepoužívá komplexní formátovač ICU z l.text. Věta jako „Přečtěte si naše <link>podmínky doručení</link> pro {region}“ je pro tuto variantu vhodná, pokud kód dodá funkci pro vykreslení odkazu a hodnotu regionu. Přidáním množného čísla nebo řadové číslovky do takové věty podporu ICU nezískáte.
Definice interakcí ponechte v kódu. Když se bohatá struktura prolíná s gramatikou, zvolte podporovaný způsob sestavení zprávy. Neznámé značky zůstávají doslovným textem a párování vnořených značek se stejným názvem má omezené možnosti. Viz Interaktivní zprávy s bohatou strukturou.
Ověřte případy, kdy se mění význam #
Otestujte počty 0, 1, 2, některé větší číslo a také desetinné číslo, pokud ho produkt umožňuje. U anglických řadových číslovek zahrňte 1, 2, 3, 11, 12, 13 a 21; u cílových jazyků ověřujte znění odpovídající danému jazyku. Otestujte neznámou hodnotu selektoru, záporné částky tam, kde dávají smysl, a tentýž okamžik v blízkosti půlnoci ve dvou časových pásmech.
Pro tyto kontroly načtěte skutečné katalogy cílových jazyků. Při chybějícím nebo prázdném překladu se může použít zdrojový text, takže ani zdánlivě správný výstup sám o sobě nepotvrzuje pokrytí cílového jazyka. Porovnejte vykreslené hodnoty se zamýšleným množstvím, datem a zprávou a poté zkontrolujte i samotný jazyk.