Components

<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.

const count = 1;
<Plural n={count}
  singular={You have one item.}
  plural={You have some items.}
/>

Referenz

Requisiten

PropTypeDefault
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-NameBeschreibung
nDie Zahl, die verwendet wird, um die Pluralform zu bestimmen. Dies ist für die Pluralisierung erforderlich.
childrenFallback-Inhalt, der gerendert wird, wenn kein passender Pluralzweig gefunden wird.
localesOptionale Lokalisierungen zur Angabe der Formatierungslokale. Wenn nicht angegeben, wird die Standardbenutzerlokale verwendet. Lesen Sie mehr über die Angabe von Lokalisierungen hier.
[key]: stringZweige, 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.

BasicExample.jsx
import { Plural } from 'gt-react';
 
export default function ItemCount({ count }) {
  return (
    <Plural n={count} 
      singular={Sie haben einen Artikel.}
      plural={Sie haben einige Artikel.}
    />
  );
}

Fallbacks

Sie können einen Fallback bereitstellen, falls der an n übergebene Wert keine passenden Zweige hat.

FallbackExample.jsx
import { Plural } from 'gt-react';
 
export default function ItemCount({ count }) {
  return (
    <Plural n={count}
      singular={Sie haben einen Artikel.}
    >
      Sie haben einige Artikel. // [!code highlight]
    </Plural>
  );
}

Plurale übersetzen

Alles, was Sie tun müssen, um zu übersetzen, ist die <T> Komponente hinzuzufügen.

PluralExample.jsx
import { T, Plural } from 'gt-react';
 
export default function ItemCount({ count }) {
  return (
  <T id="itemCount">
    <Plural n={count}
      singular={Sie haben einen Artikel.} 
      plural={Sie haben einige Artikel.} 
    />
  );
}

Variablen hinzufügen

Was ist, wenn wir einige Variablen zum pluralisierten Satz hinzufügen möchten?

PluralExample.jsx
import { T, Plural, Num } from 'gt-react';
 
export default function ItemCount({ count }) {
  return (
    <Plural n={count}
      singular={Sie haben <Num>{count}</Num> Artikel.} 
      plural={Sie haben <Num>{count}</Num> Artikel.} 
    />
  );
}

Wenn Sie sich innerhalb einer <T> Komponente befinden, umschließen Sie alle dynamischen Inhalte mit einem <Currency>, <DateTime>, <Num>, oder <Var>.

<T id="itemCount">
  <Plural n={count}
    singular={Sie haben <Num>{count}</Num> Artikel.} 
    plural={Sie haben <Num>{count}</Num> Artikel.} 
  />
</T>

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.

Auf dieser Seite