Zum Inhalt springen
Dokumentation

Komponenten

Karte (Card)

Stabil

Zusammengehörige Inhalte in einem ruhigen Rahmen – mit Kopf, Inhalt und Fußzeile.

Eine Karte fasst zusammen, was zusammengehört: eine Station mit ihrer Belegung, ein Ticket mit seinem Stand, eine Kennzahl mit ihrer Aktion. Sie gliedert die Seite, ohne selbst eine Aussage zu treffen.

Wann verwenden

  • Für eine Übersicht aus mehreren gleichartigen Einträgen, etwa die offenen Tickets einer Station.
  • Für eine Zusammenfassung mit Kopf und Fußzeile: Titel, kurze Beschreibung, Inhalt und eine Aktion am Ende.
  • Für Inhalte, die auf schmalen Bildschirmen untereinander stehen sollen – ein Raster aus Karten bricht von selbst um.

Wann nicht

  • Für die Grundstruktur einer Seite sind Abschnitte mit Überschriften passender. Zu viele Karten nebeneinander erzeugen Unruhe.
  • Für einen einzelnen Wert mit Einordnung gibt es eine Kennzahl. Eine Karte mit einem einzigen Satz wirkt leer.
  • Für tabellarische Daten mit vielen Spalten ist eine Tabelle die richtige Wahl. Karten sind kein Ersatz für Sortierung und Filter.

Aufbau

CardHeader trägt Titel und Beschreibung, CardContent den Inhalt und CardFooter die Aktionen. Der Rahmen und die Fläche kommen aus Card; jedes Teil lässt sich über className anpassen.

Station 3 – Frühdienst
Übergabe an das Team, sieben Betten belegt.
Aktiv
Die Übergabe ist für 06:30 angesetzt. Offene Punkte stehen im Dienstplan.
Beispiel und Quelltext
station.tsx
import {
  Badge,
  Button,
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@neodin-eu/ui";

function Station() {
  return (
    <Card className="w-full max-w-md">
      <CardHeader>
        <div className="flex items-start justify-between gap-3">
          <div className="flex flex-col gap-1.5">
            <CardTitle>Station 3 – Frühdienst</CardTitle>
            <CardDescription>Übergabe an das Team, sieben Betten belegt.</CardDescription>
          </div>
          <Badge variant="secondary">Aktiv</Badge>
        </div>
      </CardHeader>
      <CardContent className="text-sm">
        Die Übergabe ist für 06:30 angesetzt. Offene Punkte stehen im Dienstplan.
      </CardContent>
      <CardFooter className="gap-3">
        <Button size="sm">Dienstplan öffnen</Button>
        <Button size="sm" variant="ghost">
          Details
        </Button>
      </CardFooter>
    </Card>
  );
}

Karten im Raster

Mehrere Karten stehen in einem Grid und brechen bei wenig Platz auf eine Spalte um. Der Abstand zwischen den Karten kommt aus dem Grid, nicht aus der Karte selbst.

Rückfrage zur Bettenbelegung
Seit gestern offen
Ticket T-1042 · Station 3
Dienstplan für März
Wartet auf Freigabe
Ticket T-1043 · Station 3
Beispiel und Quelltext
raster.tsx
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@neodin-eu/ui";

const tickets = [
  { id: "T-1042", titel: "Rückfrage zur Bettenbelegung", stand: "Seit gestern offen" },
  { id: "T-1043", titel: "Dienstplan für März", stand: "Wartet auf Freigabe" },
];

function Raster() {
  return (
    <div className="grid w-full gap-4 sm:grid-cols-2">
      {tickets.map((ticket) => (
        <Card key={ticket.id}>
          <CardHeader>
            <CardTitle>{ticket.titel}</CardTitle>
            <CardDescription>{ticket.stand}</CardDescription>
          </CardHeader>
          <CardContent className="text-sm text-muted-foreground">
            Ticket {ticket.id} · Station 3
          </CardContent>
        </Card>
      ))}
    </div>
  );
}

Barrierefreiheit

  • Card und seine Teile rendern div-Elemente. Sie tragen keine eigene Rolle und keinen Tastaturfokus; die Struktur entsteht durch den Inhalt.
  • CardTitle ist ein div, keine Überschrift. Wenn der Titel in der Überschriften-Navigation eines Screenreaders auftauchen soll, gehört eine echte Überschrift wie h3 in den Inhalt.
  • Wird die ganze Karte zu einer Aktion, gehört ein Link oder eine Schaltfläche hinein – nicht ein Klick-Handler auf dem div. So bleibt der Fokus sichtbar und die Tastaturbedienung erhalten.
  • Im Komponententest rendert die Karte Titel, Beschreibung und Inhalt und ist in hell und dunkel frei von axe-Verstößen.

Props

Props von Card
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
Props von CardHeader
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
Props von CardContent
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
Props von CardFooter
PropTypStandardPflichtBeschreibung
classNamestring–Nein–

Siehe auch