Plural- und Auswahlformen
Vollständige grammatische Alternativen für Mengen und Anwendungszustände ausgeben – mit expliziten Ersatzformen.
„1 Datei ist bereit“ und „2 Dateien sind bereit“ unterscheiden sich nicht nur im Substantiv. Andere Sprachen unterscheiden nach anderen Kriterien. Stelle der Laufzeitumgebung vollständige Alternativen bereit, damit sich die gesamte Nachricht in der ausgewählten Sprache korrekt ausdrücken lässt.
Eine Form anhand einer Menge auswählen #
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" } },
);Dieses Beispiel in der Ausgangssprache gibt 2 files are ready for Ana. zurück. In einem übersetzten Katalog bestimmen die Kardinalzahlregeln der aktiven Sprache, welche Form ausgewählt wird. one ist eine grammatische Kategorie und kein allgemeingültiger Test auf die ganze Zahl 1.
plural(count: number, forms: PluralForms, options) erfordert eine other-Form. Optional sind die Kategorien zero, one, two, few und many. Die Optionen erfordern context und akzeptieren eine Map mit zusätzlichen Zeichenfolgen- oder Zahlenwerten. # zeigt die Anzahl an; die Hilfsfunktion stellt das Argument count selbst bereit und überschreibt einen eventuell vorhandenen Wert für count in dieser Map.
Die Hilfsfunktion erstellt eine ICU-Nachricht in der Reihenfolge zero, one, two, few, many, other. Die Extraktion verwendet dieselbe Erstellungslogik. Eine andere Reihenfolge der Eigenschaften ändert daher nicht die Identität. Änderungen an einer Form oder ihrem Kontext können dagegen die Identität ändern. Gib die Formen für die Extraktion als Literale an.
Eine Form anhand eines Anwendungswerts auswählen #
Verwende select für eine exakte Auswahl nach Kategorie:
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" },
);Mit dem oben angegebenen l wird View your work zurückgegeben. Bei einer unbekannten Rolle wird other verwendet. Halte Anwendungscodes wie admin von übersetzten Anzeigebezeichnungen getrennt, damit ein Sprachwechsel den ausgewählten Zustand nicht verändert.
select(value: string, forms: SelectForms, options: { context: string }): string erfordert other, sortiert beim Erstellen des ICU-Quelltexts die Schlüssel der Formen alphabetisch und stellt das Argument value bereit. Diese Hilfsfunktion bietet keine Option für zusätzliche Werte.
Exakte Anzahlen und Ordnungszahlen mit ICU-Text ausdrücken #
Die Plural-Hilfsfunktion stellt Kardinalzahlkategorien bereit. Verwende für eine exakte =0-Alternative das Beispiel mit unverarbeitetem ICU-Text. Verwende für eine Ordnungszahl eine l.text-Nachricht als Literal:
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 },
},
);Das englische Ergebnis lautet 2nd. Eine Zielvorlage braucht die entsprechende Ausdrucksweise der Zielsprache. Nur weil die umgebende Oberfläche übersetzt ist, eignen sich englische Suffixe nicht auch für andere Sprachen.
Teste für jede Zielsprache null, eins und repräsentative Kategorien sowie einen unbekannten Auswahlwert. Einschränkungen für generierte Nachrichten grenzen text und rich ein; die Plural- und Auswahl-Hilfsfunktionen behalten ihre eigenen Typen für Formen und Optionen. Sieh dir ihre extrahierten ICU-Darstellungen an und gib die Fälle aus, um sicherzustellen, dass die tatsächlich verwendeten grammatischen Varianten korrekt sind.