Num
API-Referenz für die Komponente <Num>
Überblick
Die <Num>-Komponente gibt eine formatierte Zahl als Zeichenfolge in der Spracheinstellung (locale) des Benutzers aus und kann mit Formatierungsoptions angepasst werden.
<Num>{100}</Num>
// Ausgabe: 100Alle Formatierungen erfolgen lokal mithilfe der Bibliothek Intl.NumberFormat.
Referenz
Props
Prop
Type
Beschreibung
| Prop | Beschreibung | 
|---|---|
| children | Der Inhalt, der innerhalb der Komponente gerendert wird. Typischerweise eine Zahl, die gemäß der aktuellen locale und options formatiert wird. Falls vorhanden, hat sie Vorrang vor dem Prop value. | 
| name | Optionaler Name für das Zahlenfeld, verwendet für Metadaten. | 
| value | Der Standardwert für die Zahl. Kann ein String oder eine Zahl sein. Strings werden vor der Formatierung in Zahlen geparst. | 
| options | Optionale Formatierungsoptions für die Zahl gemäß der Spezifikation Intl.NumberFormatOptions. Verwenden Sie dies, um Stile wie Währung, Dezimalstellenpräzision usw. festzulegen. | 
| locales | Optionale locales zur Festlegung der Formatierungs-locale. Wenn nicht angegeben, wird die Standard-locale des Benutzers verwendet. Weitere Informationen zum Angeben von locales finden Sie hier. | 
Rückgabe
JSX.Element, der die formatierte Zahl als String enthält.
Beispiele
Einfaches Beispiel
In diesem Beispiel wird item.quantity entsprechend der Locale des Nutzers neu formatiert.
import { Num } from 'gt-react';
export default function Inventory(item) {
  return (
    <Num> {item.quantity} </Num>  
  );
}Festlegen von locales
Standardmäßig werden locales durch die Browsereinstellungen des Nutzers bestimmt,
aber Sie können die locale für die <Num>-Komponente ausdrücklich festlegen.
import { Num } from 'gt-react';
export default function CountDisplay(item) {
  return (
    <Num locales={['fr-FR']}> {item.count} </Num> 
  );
}Übersetzen von <Num>-Komponenten
Angenommen, Sie möchten eine Zahl in einen längeren, zu übersetzenden Satz einbetten.
Fügen Sie einfach <T>-Komponenten um den Inhalt hinzu.
import { T, Num } from 'gt-react';
export default function DynamicPriceDisplay(item) {
  return (
    <T id="price">
      Es sind <Num> {item.count} </Num> Stück verfügbar. // [!code highlight]
    </T>
  );
}Benutzerdefinierte Formatierung
<Num> nutzt die Bibliothek Intl.NumberFormat zum Formatieren.
import { Num } from 'gt-react';
export default function CustomFormat(number) {
  return (
    <Num
      options={{ style: "decimal", maximumFractionDigits: 2 }}
    >
      {number}
    </Num>
  );
}Hinweise
- Die <Num>-Komponente formatiert Zahlen gemäß der locale des Nutzers.
- Wenn sie innerhalb einer <T>-Komponente verwendet wird, achten Sie darauf, alle dynamischen Zahlen in eine<Num>-Komponente zu kapseln.
Nächste Schritte
- Weitere Details und Use‑Cases zur <Num>-Komponente sowie zu anderen Variablenkomponenten wie<Currency>,<DateTime>und<Var>,
Wie ist dieser Leitfaden?

