<Plural>
API-Referenz für die <Plural>-Komponente
Übersicht
Wir verwenden die <Plural>
-Komponente, um Sätze zu konjugieren.
Denken Sie an den Unterschied zwischen den Sätzen: „Sie haben einen Artikel.“ und „Sie haben zwei Artikel.“
Im Englischen müssen Sie zwei verschiedene Sätze je nach Anzahl der Artikel definieren. In anderen Sprachen müssen Sie bis zu sechs definieren.
const count = 1;
<Plural n={count}
singular={You have one item.}
plural={You have some items.}
/>
Referenz
Eigenschaften
Prop | Type | Default |
---|---|---|
[key]: string? | string | JSX.Element | - |
locales?? | string[] | undefined |
children?? | any | undefined |
n? | number | - |
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
Eigenschaftsname | Beschreibung |
---|---|
n | Die Zahl, die zur Bestimmung der Pluralform verwendet wird. Dies ist für die Pluralisierung erforderlich. |
children | Fallback-Inhalt, der angezeigt wird, wenn kein passender Pluralzweig gefunden wird. |
locales | Optionale Locales zur Angabe des Formatierungs-Locale. Wenn nicht angegeben, wird das Standard-Locale des Benutzers verwendet. Mehr über die Angabe von Locales erfahren Sie hier. |
[key]: string | Zweige, die Pluralformen darstellen. Die genauen Zweige hängen vom Locale ab. |
Rückgabewert
JSX.Element
, das den Inhalt entsprechend der Pluralform von n
oder den Fallback-Inhalt enthält.
Fehler
Error
, wenn n
nicht angegeben ist 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 mit
"en-US"
sind, 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 die Pluralisierung zu handhaben.
import { Plural } from 'gt-react';
export default function ItemCount({ count }) {
return (
<Plural n={count}
singular={You have one item.}
plural={You have some items.}
/>
);
}
Fallbacks
Sie können einen Fallback angeben, falls der an n
übergebene Wert keine passenden Zweige hat.
import { Plural } from 'gt-react';
export default function ItemCount({ count }) {
return (
<Plural n={count}
singular={You have one item.}
>
You have some items. // [!code highlight]
</Plural>
);
}
Plurale übersetzen
Alles, was Sie tun müssen, um zu übersetzen, ist die <T>
-Komponente hinzuzufügen.
import { T, Plural } from 'gt-react';
export default function ItemCount({ count }) {
return (
<T id="itemCount">
<Plural n={count}
singular={You have an item.}
plural={You have some items.}
/>
);
}
Variablen hinzufügen
Was ist, wenn wir der pluralisierten Aussage Variablen hinzufügen möchten?
import { T, Plural, Num } from 'gt-react';
export default function ItemCount({ count }) {
return (
<Plural n={count}
singular={You have <Num>{count}</Num> item.}
plural={You have <Num>{count}</Num> items.}
/>
);
}
Wenn Sie sich innerhalb einer <T>
-Komponente befinden, umschließen Sie alle dynamischen Inhalte mit <Currency>
, <DateTime>
, <Num>
oder <Var>
.
<T id="itemCount">
<Plural n={count}
singular={You have <Num>{count}</Num> item.}
plural={You have <Num>{count}</Num> items.}
/>
</T>
Hinweise
- Die
<Plural>
-Komponente wird verwendet, um Pluralformen zu handhaben. - Die verfügbaren Pluralzweige (z. B. one, other, few, many) hängen von der jeweiligen Sprache ab und folgen den Unicode CLDR-Pluralisierungsregeln.
Nächste Schritte
- Weitere Beispiele findest du in der Referenzdokumentation zu verzweigten Komponenten hier.
- Für fortgeschrittene Anwendungsfälle kombiniere
<Plural>
mit Variablenkomponenten wie<Currency>
,<DateTime>
,<Num>
und<Var>
. Mehr über Variablenkomponenten erfährst du hier.
Für einen tieferen Einblick in Pluralisierung und Verzweigungen besuche Verwendung von verzweigten Komponenten.
Wie ist dieser Leitfaden?