<Plural>
API-Referenz für die <Plural>-Komponente
Überblick
Wir verwenden die <Plural>
Komponente, um Sätze zu konjugieren.
Denken Sie an den Unterschied zwischen den Sätzen: "Du hast einen Gegenstand." und "Du hast zwei Gegenstände."
Im Englischen müssen Sie zwei verschiedene Sätze basierend auf der Anzahl der Gegenstände definieren. In anderen Sprachen müssen Sie bis zu sechs definieren.
Referenz
Requisiten
Prop | Type | Default |
---|---|---|
n? | number | - |
children?? | any | undefined |
locales?? | string[] | undefined |
[key]: string? | string | JSX.Element | - |
Die [key]: string
Syntax zeigt beliebige Schlüssel an, die potenzielle Pluralisierungszweige darstellen.
Zum Beispiel können Zweige wie singular
und plural
als Parameter hinzugefügt werden.
Beschreibung
Prop-Name | Beschreibung |
---|---|
n | Die Zahl, die verwendet wird, um die Pluralform zu bestimmen. Dies ist für die Pluralisierung erforderlich. |
children | Fallback-Inhalt, der gerendert wird, wenn kein passender Pluralzweig gefunden wird. |
locales | Optionale Lokalisierungen zur Angabe der Formatierungslokale. Wenn nicht angegeben, wird die Standardbenutzerlokale verwendet. Lesen Sie mehr über die Angabe von Lokalisierungen hier. |
[key]: string | Zweige, die Pluralformen darstellen. Die genauen Zweige hängen von der Lokale ab. |
Rückgaben
JSX.Element
, das den Inhalt enthält, der der Pluralform von n
entspricht, oder den Fallback-Inhalt.
Ausnahmen
Error
, wenn n
nicht angegeben oder keine gültige Zahl ist.
Welche Formen sollte ich hinzufügen?
Sie müssen nur die Pluralformen in Ihrer Sprache verwenden.
Die möglichen Formen sind: "singular"
, "plural"
, "dual"
, "zero"
, "one"
, "two"
, "few"
, "many"
, "other"
.
- Wenn Sie ein Entwickler sind, der
"en-US"
verwendet, verwenden Sie nur zwei:"singular"
und"plural"
. - Wenn Sie ein Entwickler in
"zh-CN"
sind, verwenden Sie nur"other"
.
Lesen Sie mehr über die verschiedenen Formen hier.
Beispiele
Grundlegende Verwendung
Verwenden Sie die <Plural>
Komponente, um Pluralformen zu handhaben.
Fallbacks
Sie können einen Fallback bereitstellen, falls der an n
übergebene Wert keine passenden Zweige hat.
Plurale übersetzen
Alles, was Sie tun müssen, um zu übersetzen, ist die <T>
Komponente hinzuzufügen.
Variablen hinzufügen
Was ist, wenn wir einige Variablen zum pluralisierten Satz hinzufügen möchten?
Wenn Sie sich innerhalb einer <T>
Komponente befinden, umschließen Sie alle dynamischen Inhalte mit einem <Currency>
, <DateTime>
, <Num>
, oder <Var>
.
Notizen
- Die
<Plural>
Komponente wird verwendet, um Pluralisierung zu handhaben. - Die verfügbaren Pluralzweige (z.B. one, other, few, many) hängen von der Sprache ab und folgen den Unicode CLDR Pluralisierungsregeln.
Nächste Schritte
- Für weitere Beispiele, schauen Sie sich das Referenzdokument zu verzweigenden Komponenten hier an.
- Für eine fortgeschrittene Nutzung kombinieren Sie
<Plural>
mit variablen Komponenten wie<Currency>
,<DateTime>
,<Num>
, und<Var>
. Lesen Sie mehr über variable Komponenten hier.
Für einen tieferen Einblick in Pluralisierung und Verzweigung besuchen Sie Verzweigende Komponenten verwenden.