Zum Inhalt springen
Dokumentation

Komponenten

Avatar

Stabil

Eine 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 StatusBadge oder PriorityBadge. 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ß
Beispiel und Quelltext
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.

  • AB
    Alina BergerStationsleitung
  • MY
    Mert YilmazPflegefachkraft
  • JW
    Jonas WeberAuszubildender
Beispiel und Quelltext
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

  • Avatar und seine Teile rendern span-Elemente. Sie tragen keine eigene Rolle und keinen Tastaturfokus; der Inhalt wird im Fluss der Zeile gelesen.
  • AvatarFallback liefert den Text, den ein Screenreader vorliest – hier die Initialen. Deshalb steht der Name zusätzlich daneben, wie im Dienstplan- Beispiel.
  • AvatarImage stammt von Radix und rendert das Bild erst, wenn es geladen ist; bis dahin bleibt der Rückfall sichtbar. Ein alt-Text gehört zum Bild, wenn es eine Aussage trägt. Rein schmückende Bilder bekommen ein leeres alt.
  • Im Komponententest zeigt der Avatar ohne Bild die Initialen und ist in hell und dunkel frei von axe-Verstößen.

Props

Props von Avatar
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von AvatarFallback
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von AvatarImage
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–

Siehe auch