Plurály a výběry

Vykreslujte úplné gramatické varianty pro různá množství a stavy aplikace s výslovně určenými záložními tvary.

Ve větách „1 soubor je připraven“ a „2 soubory jsou připraveny“ se mění víc než jen podstatné jméno. Další jazyky rozlišují zase jiné případy. Předejte běhovému prostředí úplné varianty, aby bylo možné celou zprávu ve zvoleném jazyce vyjádřit správně.

Výběr tvaru podle množství #

ts
import { createLingo } from "@lingo.dev/react";

const l = createLingo("en");
const message = l.plural(
  2,
  {
    one: "# file is ready for {name}.",
    other: "# files are ready for {name}.",
  },
  { context: "Files ready for download", values: { name: "Ana" } },
);

Tento příklad ve zdrojovém jazyce vrátí 2 files are ready for Ana.. V přeloženém katalogu se tvar vybírá podle pravidel pro základní číslovky aktivního jazyka. Kategorie one je gramatická kategorie, nikoli univerzální test rovnosti s celým číslem 1.

plural(count: number, forms: PluralForms, options) vyžaduje tvar other. Kategorie zero, one, two, few a many jsou nepovinné. Volby vyžadují context a přijímají mapu dalších řetězcových nebo číselných hodnot. # zobrazuje počet; pomocná funkce sama předává argument count a přepíše případnou hodnotu count v této mapě.

Pomocná funkce sestavuje zprávu ICU v pořadí zero, one, two, few, many, other. Extrakce používá stejnou sestavovací funkci, takže změna pořadí vlastností nemění identitu zprávy. Změna tvaru nebo jeho kontextu ji však změnit může. Kvůli extrakci zapisujte tvary jako literály.

Výběr tvaru podle hodnoty v aplikaci #

Pro výběr podle přesné shody s kategorií použijte select:

ts
const action = l.select(
  "member",
  {
    admin: "Manage the team",
    member: "View your work",
    other: "Open your account",
  },
  { context: "Primary navigation action for the signed-in account role" },
);

S výše uvedenou hodnotou l vrátí tento příklad View your work. Pro neznámou roli se použije other. Kódy aplikace, například admin, uchovávejte odděleně od přeložených popisků v rozhraní, aby změna jazyka nezměnila vybraný stav.

select(value: string, forms: SelectForms, options: { context: string }): string vyžaduje other, při sestavování zdrojové zprávy ICU řadí klíče tvarů abecedně a předává argument value. Tato pomocná funkce nenabízí volbu pro další hodnoty.

Vyjádření přesných počtů a řadových číslovek pomocí textu ICU #

Pomocná funkce pro plurály nabízí kategorie základních číslovek. Pro variantu odpovídající přesné hodnotě =0 použijte příklad přímo ve formátu ICU. Pro řadovou číslovku použijte zprávu l.text zapsanou jako literál:

ts
const position = l.text(
  "{position, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}",
  {
    context: "Finishing position in a ranked result, using English source suffixes",
    values: { position: 2 },
  },
);

Výsledkem v angličtině je 2nd. Cílová šablona musí používat vyjádření odpovídající cílovému jazyku; samotný překlad okolního rozhraní neznamená, že se anglické přípony hodí i do jiných jazyků.

Pro každý cílový jazyk otestujte nulu, jedničku a reprezentativní případy jednotlivých kategorií i neznámou hodnotu výběru. Omezení generovaných zpráv zužují typy text a rich; pomocné funkce pro plurály a výběry si zachovávají vlastní typy tvarů a voleb. Prohlédněte si jejich extrahované reprezentace ve formátu ICU a vykreslete jednotlivé případy, abyste ověřili, které gramatické větve se skutečně použijí.