Components

<Num>

API-Referenz für die Komponente <Num>

Übersicht

Die Komponente <Num> rendert eine formatierte Zahlenzeichenfolge in der locale des Benutzers und kann mit formatting options angepasst werden.

<Num>{100}</Num>
// Ausgabe: 100

Alle Formatierungen erfolgen lokal mit der Bibliothek Intl.NumberFormat.

Referenzen

Props

Prop

Type

Beschreibung

PropBeschreibung
childrenDer Inhalt, der innerhalb der Komponente gerendert wird. In der Regel eine Zahl, die entsprechend der aktuellen locale und options formatiert wird. Falls angegeben, hat sie Vorrang vor der value‑Prop.
nameOptionaler Name für das Zahlenfeld, der für Metadatenzwecke verwendet wird.
valueDer Standardwert der Zahl. Kann ein String oder eine Zahl sein. Strings werden vor dem Formatieren in Zahlen umgewandelt.
optionsOptionale Formatierungsoptions für die Zahl gemäß der Spezifikation Intl.NumberFormatOptions. Verwenden Sie dies, um Stile wie Währung, Dezimalgenauigkeit usw. zu definieren.
localesOptionale locales zur Angabe der Formatierungslocale. Wenn nicht angegeben, wird die Standardlocale des Benutzers verwendet. Mehr über die Angabe von locales erfahren 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 Nutzers neu formatiert.

QuantityDisplay.jsx
import { Num } from 'gt-react';

export default function Bestand(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 explizit festlegen.

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

DynamicPriceDisplay.jsx
import { T, Num } from 'gt-react';

export default function DynamicPriceDisplay(item) {
  return (
    <T id="price">
      <Num> {item.count} </Num> Einheiten verfügbar. // [!code highlight]
    </T>
  );
}

Benutzerdefiniertes Formatieren

<Num> verwendet 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 Komponente <Num> wird verwendet, um Zahlen entsprechend der locale eines Benutzers zu formatieren.
  • Wenn sie innerhalb einer <T>-Komponente verwendet wird, achten Sie darauf, alle dynamischen Zahlen in eine <Num>-Komponente zu setzen.

Nächste Schritte

  • Weitere Details und Anwendungsbeispiele zur <Num>‑Komponente sowie zu anderen Variablenkomponenten wie <Currency>, <DateTime> und <Var>,

Wie ist diese Anleitung?