Num
API Reference für die <Num>-Komponente
Übersicht
Die Komponente <Num> gibt eine formatierte Zahl als Zeichenfolge in der locale des Benutzers aus und lässt sich mit Formatierungsoptions anpassen.
<Num>{100}</Num>
// Ausgabe: 100Alle Umformatierungen erfolgen lokal mit der Bibliothek Intl.NumberFormat.
Referenz
Props
Prop
Type
Beschreibung
| Prop | Beschreibung |
|---|---|
children | Der Inhalt, der innerhalb der Komponente gerendert wird. In der Regel eine Zahl, die entsprechend der aktuellen locale und options formatiert wird. Falls angegeben, hat children Vorrang vor dem Prop value. |
name | Optionaler Name für das Zahlenfeld, verwendet für Metadatenzwecke. |
value | Der Standardwert für die Zahl. Kann ein String oder eine Zahl sein. Strings werden vor der Formatierung in Zahlen umgewandelt. |
options | Optionale options für die Formatierung der Zahl gemäß der Spezifikation von Intl.NumberFormatOptions. Verwenden Sie dies, um Stile wie Währung, Dezimalgenauigkeit usw. zu definieren. |
locales | Optionale locales zur Angabe der Formatierungslocale. Wenn nicht angegeben, wird die Standardlocale des Benutzers verwendet. Weitere Informationen zur Angabe von locales finden Sie hier. |
Rückgabe
JSX.Element, der die formatierte Zahl als Zeichenfolge enthält.
Beispiele
Einfaches Beispiel
In diesem Beispiel wird item.quantity gemäß der Locale des Nutzers neu formatiert.
import { Num } from 'gt-next';
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 Komponente <Num> explizit festlegen.
import { Num } from 'gt-next';
export default function CountDisplay(item) {
return (
<Num locales={['fr-FR']}> {item.count} </Num>
);
}Übersetzen von <Num>-Komponenten
Angenommen, Sie möchten Ihre Zahl in einen längeren, zu übersetzenden Satz einbetten.
Fügen Sie einfach die <T>-Komponenten um den Inhalt herum hinzu.
import { T, Num } from 'gt-next';
export default function DynamicPriceDisplay(item) {
return (
<T id="price">
<Num> {item.count} </Num> Einheiten verfügbar. // [!code highlight]
</T>
);
}Benutzerdefiniertes Formatieren
<Num> nutzt die Bibliothek Intl.NumberFormat zum Formatieren.
import { Num } from 'gt-next';
export default function CustomFormat(number) {
return (
<Num
options={{ style: "decimal", maximumFractionDigits: 2 }}
>
{number}
</Num>
);
}Hinweise
- Die Komponente
<Num>wird verwendet, um Zahlen entsprechend der locale eines Benutzers zu formatieren. - Innerhalb einer
<T>-Komponente sollten alle dynamischen Zahlen in eine<Num>-Komponente eingebettet werden.
Nächste Schritte
- Weitere Details und Anwendungsbeispiele zur
<Num>-Komponente sowie zu anderen Variablen-Komponenten wie<Currency>,<DateTime>und<Var>,
Wie ist diese Anleitung?