Num
API-Referenz für die Komponente <Num>
Übersicht
Die <Num>-Komponente rendert eine formatierte Zahl als String in der locale des Benutzers und kann mit Formatierungsoptions angepasst werden.
<Num>{100}</Num>
// Ausgabe: 100Alle Formatierungen erfolgen lokal mit der Bibliothek Intl.NumberFormat.
Referenzen
Props
Prop
Type
Beschreibung
| Prop | Beschreibung | 
|---|---|
| children | Der Inhalt, der innerhalb der Komponente gerendert wird. In der Regel eine Zahl, die gemäß der aktuellen locale und den options formatiert wird. Wenn vorhanden, hat childrenVorrang vor dervalue-Prop. | 
| name | Optionaler Name für das Zahlenfeld, verwendet für Metadaten. | 
| value | Der Standardwert für die Zahl. Kann eine Zeichenfolge oder eine Zahl sein. Zeichenfolgen werden vor der Formatierung in Zahlen umgewandelt. | 
| options | Optionale Formatierungs-options für die Zahl gemäß der Spezifikation Intl.NumberFormatOptions. Verwenden Sie dies, um Stile wie Währung, Dezimalgenauigkeit usw. festzulegen. | 
| locales | Optionale locales, um die Formatierungs-locale festzulegen. Wenn nicht angegeben, wird die Standard-locale des Benutzers verwendet. Weitere Informationen zur Angabe von locales finden Sie hier. | 
Rückgabewert
JSX.Element, der die formatierte Zahl als String enthält.
Beispiele
Einfaches Beispiel
In diesem Beispiel wird item.quantity entsprechend der Locale des Benutzers 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 du kannst die locale für die <Num>-Komponente 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 einem längeren, zu übersetzenden Satz verwenden.
Wickeln Sie dazu einfach den Inhalt mit <T>-Komponenten ein.
import { T, Num } from 'gt-next';
export default function DynamicPriceDisplay(item) {
  return (
    <T id="price">
      Es sind <Num> {item.count} </Num> Einheiten verfügbar. // [!code highlight]
    </T>
  );
}Individuelle Formatierung
<Num> nutzt die Bibliothek Intl.NumberFormat zur Formatierung.
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 gemäß der locale des Nutzers zu formatieren.
- Wenn sie innerhalb einer <T>-Komponente verwendet wird, stellen Sie sicher, dass alle dynamischen Zahlen in eine<Num>-Komponente eingeschlossen werden.
Nächste Schritte
- Weitere Details und Anwendungsbeispiele zur Komponente <Num>sowie zu anderen Variablenkomponenten wie<Currency>,<DateTime>und<Var>,
Wie ist dieser Leitfaden?

