mittwald Flow Logo

Components

DonutChart

Das DonutChart dient zur übersichtlichen Darstellung proportionaler Daten in einem ringförmigen Diagramm. Es eignet sich besonders zur Visualisierung von Verteilungen, Anteilen oder Fortschritten.GitHub
30 %

Playground

Verwende <DonutChart />, um ein DonutChart darzustellen.

30 %
import { DonutChart } from "@mittwald/flow-react-components";

<DonutChart value={30} aria-label="Auslastung" />

Mit Unit

Im default wird das DonutChart immer mit Prozentangabe angezeigt. Über das Property formatOptions können aber auch andere Einheiten gewählt werden. (s. Intl.NumberFormat)

Gigabyte

12 GB
import { DonutChart } from "@mittwald/flow-react-components";

<DonutChart
  aria-label="Speicherplatz"
  formatOptions={{ style: "unit", unit: "gigabyte" }}
  maxValue={50}
  value={12}
/>

Dezimalzahl

135
import { DonutChart } from "@mittwald/flow-react-components";

<DonutChart
  aria-label="Performance"
  formatOptions={{ style: "decimal" }}
  maxValue={200}
  value={135}
/>

Größen

Die Size des DonutCharts kann Medium oder Large sein. Medium ist dabei die Standardgröße.

30 %
30 %
import { DonutChart } from "@mittwald/flow-react-components";

<Row>
  <DonutChart value={30} aria-label="Auslastung" />
  <DonutChart value={30} aria-label="Auslastung" size="l" />
</Row>

Mit alternativem Text

Über die children kann der Text innerhalb des DonutCharts überschrieben werden

300GB
import { DonutChart } from "@mittwald/flow-react-components";

<DonutChart
  value={300}
  maxValue={600}
  aria-label="Speicherplatz"
>
  <b>300</b>
  <small>GB</small>
</DonutChart>

Status

Je nach Anwendungsfall stehen vier Status-Farben zur Auswahl: Info, Success, Warning und Danger.

30 %
30 %
80 %
95 %
import { DonutChart } from "@mittwald/flow-react-components";

<Row>
  <DonutChart
    value={30}
    status="success"
    aria-label="Auslastung"
  />
  <DonutChart value={30} aria-label="Auslastung" />
  <DonutChart
    value={80}
    status="warning"
    aria-label="Auslastung"
  />
  <DonutChart
    value={95}
    status="danger"
    aria-label="Auslastung"
  />
</Row>

Segmente

Die Anzeige des DonutCharts kann über das segments Property um einzelne Abschnitte ergänzt werden. Der value ergibt sich in diesem Fall aus der Summe der Werte der einzelnen Segmente. Um die einzelnen Werte näher zu erläutern wird automatisch die Legend Component angezeigt. Über das showLegend Property kann diese ein- und ausgeblendet werden. Die Position der Legende kann über das Property legendPosition bestimmt werden.

Die Farben der Segmente werden automatisch festgelegt, können aber über das color Property überschrieben werden. Beim Überschreiben muss darauf geachtet werden, dass nebeneinander liegende Farben weiterhin einen ausreichenden Kontrast zueinander haben.

100 %
  • Item 1 (28 %)
  • Item 2 (24 %)
  • Item 3 (20 %)
  • Item 4 (10 %)
  • Item 5 (12 %)
  • Item 6 (6 %)
import { DonutChart } from "@mittwald/flow-react-components";

<DonutChart
  aria-label="Items"
  segments={[
    { title: "Item 1", value: 28 },
    { title: "Item 2", value: 24 },
    { title: "Item 3", value: 20 },
    { title: "Item 4", value: 10 },
    { title: "Item 5", value: 12 },
    { title: "Item 6", value: 6 },
  ]}
/>

Overview