Verwende Alerts, um z. B. ...
- den User auf sicherheits- oder funktionsrelevante Informationen hinzuweisen.
- vor möglichen Problemen oder Systemzuständen zu warnen.
- dringende oder aktionsrelevante Statusmeldungen zu kommunizieren.
Alert
Ein Alert macht den User visuell hervorgehoben auf wichtige, nicht ignorierbare Informationen aufmerksam.import { Alert, Heading, } from "@mittwald/flow-react-components"; <Alert> <Heading>E-Mail-Adresse wurde archiviert</Heading> </Alert>
Best Practices
- Setze einen Alert nur ein, wenn der Inhalt eine hohe Aufmerksamkeit verlangt. Für rein informative Hinweise reicht oft ein unauffälligeres Element.
- Wähle den Schweregrad passend zur Bedeutung der Meldung. Welcher Status wofür steht, beschreibt das Informationskonzept.
- Formuliere den Text klar, prägnant und lösungsorientiert. Verzichte auf Fachbegriffe und Schuldzuweisungen und beachte die Content Guidelines für Fehlermeldungen.
- Biete nach Möglichkeit eine Handlungsmöglichkeit an. Zum Beispiel über einen Button oder Link.
Alert vs. AccentBox
Alerts und AccentBoxen dienen beide dazu, dem User zusätzliche Informationen bereitzustellen. Eine einfache Faustregel hilft bei der Entscheidung: Kann die Information ignoriert werden, ohne negative Folgen? Dann ist eine AccentBox die richtige Wahl. Wenn das Ignorieren hingegen zu Problemen führen könnte – etwa bei sicherheitsrelevanten Hinweisen oder wichtigen Systemmeldungen – sollte ein Alert mit entsprechendem Status verwendet werden.
Verwende AccentBoxen, um z. B. ...
- ergänzende, aber nicht kritische Hinweise anzuzeigen.
- kontextuelle Informationen oder Tipps zu geben.
- visuell strukturierende Inhalte einzubetten, ohne zu unterbrechen.
Mit Inhalt
Über den Content beschreibst du zuerst die Ursache – was ist passiert und welche Folge ergibt sich – und anschließend, was der User tun kann. Wenn möglich, biete ihm eine Möglichkeit, sein Problem zu lösen, über einen Link oder einen Button. Eingefügte Buttons werden automatisch in der Größe Small dargestellt, um ein ausgewogenes Gesamtbild zu gewährleisten.
Status
Je nach Anwendungsfall stehen verschiedene Status-Farben zur Auswahl:
- Info – Allgemeine Systemzustände oder laufende Prozesse, die keine Aktion erfordern.
- Warning – Hinweise auf mögliche Risiken mit einer klaren Handlungsempfehlung.
- Danger – Akute Fehlerzustände oder kritische Probleme, die sofortige Aufmerksamkeit erfordern.
- Success – Abgeschlossene, erfolgreiche oder positiv bewertete Zustände.
- Unavailable – Zustände aufgrund von nicht verfügbaren oder gelöschten Inhalten.
Position
Ein Alert sollte immer in unmittelbarem Zusammenhang mit dem betroffenen Inhalt platziert werden.
In einer Section
Bezieht sich der Alert auf eine bestimmte Section, wird er in deren Content platziert.
E-Mail-Adresse
...Speicherplatz
...Seitenweit
Gilt sein Hinweis für die gesamte Seite, wird er prominent oberhalb der ersten Section innerhalb der LayoutCard platziert.
E-Mail-Adresse
...Speicherplatz
...Properties
| Property | Type | Default | Description |
|---|---|---|---|
status | "info" | "success" | "warning" | "danger" | "unavailable" | - | The elements status |
wrapWith | ReactElement<unknown, string | JSXElementConstructor<any>> | - | A React element the component is wrapped with. The element is cloned and receives the component as its only child — useful to render the component inside a link, a tooltip trigger or any other wrapper without changing the surrounding markup. |
Accessibility
| Property | Type | Default | Description |
|---|---|---|---|
aria-describedby | string | - | Identifies the element (or elements) that describes the object. @see aria-labelledby |
aria-hidden | Booleanish | - | Indicates whether the element is exposed to an accessibility API. @see aria-disabled. |
aria-label | string | - | Defines a string value that labels the current element. @see aria-labelledby. |
aria-labelledby | string | - | Identifies the element (or elements) that labels the current element. @see aria-describedby. |