Komponenten
Avatar
StabilEine Person in Listen und Übergaben – mit Initialen als Rückfall.
Ein Avatar stellt eine Person kompakt dar: in einer Dienstplanzeile, in einer Übergabeliste oder neben einer Änderung im Verlauf. Wenn kein Bild vorliegt, zeigen die Initialen, wer gemeint ist – ein Foto ist nicht nötig.
Wann verwenden
- In Listen, in denen Personen vorkommen: Dienstplan, Übergabe, Kommentare, Änderungsverlauf.
- Wenn der Name daneben steht und der Avatar die Zeile schneller erfassbar macht.
- In Kopfbereichen von Profilen und bei „zugewiesen an“-Angaben am Ticket.
- Wenn es kein passendes Bild gibt: Die Initialen sind der übliche Rückfall und brauchen keine zusätzliche Gestaltung.
Wann nicht
- Als einzige Angabe, wer gemeint ist. Die Initialen sind mehrdeutig; der Name gehört immer dazu.
- Für Gruppen, Abteilungen und Stationen ist ein Symbol oder eine Kennzeichnung besser geeignet als ein Personenkreis.
- Für Status- oder Prioritätsangaben nimm
StatusBadgeoderPriorityBadge. Ein Avatar sagt nichts über den Zustand eines Eintrags. - Für echte Lichtbilder von Beschäftigten oder von Patient:innen: In dieser Dokumentation und in Beispielen stehen nur Initialen. Fotos von Personen gehören nicht in die Bibliothek.
Initialen
AvatarFallback zeigt die Initialen, solange kein Bild geladen ist. Die
Größe kommt über className; Standard ist size-9, die Schriftgröße wächst
mit.
ABStandard
MYMittel
JWGroß
initialen.tsx
import { Avatar, AvatarFallback } from "@neodin-eu/ui";
function Initialen() {
return (
<div className="flex flex-wrap items-end gap-6">
<div className="flex flex-col items-center gap-2">
<Avatar>
<AvatarFallback>AB</AvatarFallback>
</Avatar>
<span className="text-xs text-muted-foreground">Standard</span>
</div>
<div className="flex flex-col items-center gap-2">
<Avatar className="size-12">
<AvatarFallback className="text-sm">MY</AvatarFallback>
</Avatar>
<span className="text-xs text-muted-foreground">Mittel</span>
</div>
<div className="flex flex-col items-center gap-2">
<Avatar className="size-14">
<AvatarFallback className="text-base">JW</AvatarFallback>
</Avatar>
<span className="text-xs text-muted-foreground">Groß</span>
</div>
</div>
);
}Im Dienstplan
Steht der Avatar in einer Liste, trägt er zusammen mit Name und Rolle die Zeile. Die Initialen wiederholen nur, was der Name schon sagt – die Zeile bleibt auch ohne Bild verständlich.
- ABAlina BergerStationsleitung
- MYMert YilmazPflegefachkraft
- JWJonas WeberAuszubildender
team.tsx
import { Avatar, AvatarFallback } from "@neodin-eu/ui";
const TEAM = [
{ initials: "AB", name: "Alina Berger", role: "Stationsleitung" },
{ initials: "MY", name: "Mert Yilmaz", role: "Pflegefachkraft" },
{ initials: "JW", name: "Jonas Weber", role: "Auszubildender" },
];
function Team() {
return (
<ul className="w-full max-w-md divide-y divide-border rounded-xl border border-border bg-background">
{TEAM.map((person) => (
<li key={person.initials} className="flex items-center gap-3 px-4 py-3">
<Avatar>
<AvatarFallback>{person.initials}</AvatarFallback>
</Avatar>
<div className="flex flex-col">
<span className="text-sm font-medium">{person.name}</span>
<span className="text-xs text-muted-foreground">{person.role}</span>
</div>
</li>
))}
</ul>
);
}Barrierefreiheit
Avatarund seine Teile rendernspan-Elemente. Sie tragen keine eigene Rolle und keinen Tastaturfokus; der Inhalt wird im Fluss der Zeile gelesen.AvatarFallbackliefert den Text, den ein Screenreader vorliest – hier die Initialen. Deshalb steht der Name zusätzlich daneben, wie im Dienstplan- Beispiel.AvatarImagestammt von Radix und rendert das Bild erst, wenn es geladen ist; bis dahin bleibt der Rückfall sichtbar. Einalt-Text gehört zum Bild, wenn es eine Aussage trägt. Rein schmückende Bilder bekommen ein leeresalt.- Im Komponententest zeigt der Avatar ohne Bild die Initialen und ist in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |