Zum Inhalt springen
Dokumentation

Komponenten

Scrollbereich (ScrollArea)

Stabil

Lange Listen in einem festen Rahmen scrollen – mit sichtbarer Bildlaufleiste in beiden Richtungen.

Ein Scrollbereich gibt langen Inhalten einen festen Rahmen: Die Liste der Betten, die Schichten des Tages oder die Einträge einer Zeitleiste scrollen innerhalb der Fläche, während die übrige Seite stehen bleibt. Die Bildlaufleiste bleibt dabei sichtbar und ruhig gestaltet.

Wann verwenden

  • Für Listen, die länger sind als ihr Platz – etwa die Betten einer Station in einer Seitenspalte.
  • Für waagerecht angeordnete Inhalte wie die Schichten des Tages, die sonst umbrechen würden.
  • Wenn der Rahmen nicht mitwachsen soll, damit die umgebende Ansicht stabil bleibt.

Wann nicht

  • Wenn der Inhalt auf die Seite passt, ist Scrollen im Scrollbereich ein zweiter Scrollbalken. Lass die Seite selbst scrollen.
  • Für sehr lange Listen mit Suche und Auswahl ist eine Tabelle mit Filter die bessere Wahl.
  • Für Inhalte, die vollständig gelesen werden müssen, etwa eine Einwilligung, ist ein eigener Abschnitt ohne eigenen Überlauf besser.

Aufbau

ScrollArea legt den Rahmen und den scrollenden Bereich an. Die Höhe kommt über className, etwa h-56; der Inhalt bleibt normaler Fluss. Für waagerechtes Scrollen ergänzt ScrollBar mit orientation="horizontal" eine zweite Leiste.

  • 101 · Belegt · Entlassung geplant
  • 102 · Belegt · Visite um 9 Uhr
  • 103 · Frei · gereinigt
  • 104 · Belegt · Aufnahme aus Notaufnahme
  • 105 · Belegt · Verlegung an Station 2
  • 106 · Frei · defekt gemeldet
  • 107 · Belegt · Entlassung geplant
  • 108 · Belegt · Isolierung
  • 109 · Frei · gereinigt
  • 110 · Belegt · Visite um 9 Uhr
  • 111 · Belegt · Aufnahme angekündigt
  • 112 · Belegt · Entlassung geplant
  • 113 · Frei · gereinigt
  • 114 · Belegt · Verlegung intern
  • 115 · Belegt · Isolierung
  • 116 · Frei · gereinigt
  • 117 · Belegt · Visite um 11 Uhr
  • 118 · Belegt · Aufnahme aus Notaufnahme
  • 119 · Belegt · Entlassung geplant
  • 120 · Frei · defekt gemeldet
Beispiel und Quelltext
betten.tsx
import { ScrollArea } from "@neodin-eu/ui";

const betten = [
  "101 · Belegt · Entlassung geplant",
  "102 · Belegt · Visite um 9 Uhr",
  "103 · Frei · gereinigt",
  "104 · Belegt · Aufnahme aus Notaufnahme",
  "105 · Belegt · Verlegung an Station 2",
  "106 · Frei · defekt gemeldet",
  "107 · Belegt · Entlassung geplant",
  "108 · Belegt · Isolierung",
  "109 · Frei · gereinigt",
  "110 · Belegt · Visite um 9 Uhr",
  "111 · Belegt · Aufnahme angekündigt",
  "112 · Belegt · Entlassung geplant",
  "113 · Frei · gereinigt",
  "114 · Belegt · Verlegung intern",
  "115 · Belegt · Isolierung",
  "116 · Frei · gereinigt",
  "117 · Belegt · Visite um 11 Uhr",
  "118 · Belegt · Aufnahme aus Notaufnahme",
  "119 · Belegt · Entlassung geplant",
  "120 · Frei · defekt gemeldet",
];

function Betten() {
  return (
    <ScrollArea className="h-56 w-full max-w-sm rounded-md border border-border">
      <ul
        aria-label="Betten der Station 3"
        tabIndex={0}
        className="divide-y divide-border rounded-sm p-2 outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
      >
        {betten.map((bett) => (
          <li key={bett} className="px-2 py-2 text-sm text-foreground">
            {bett}
          </li>
        ))}
      </ul>
    </ScrollArea>
  );
}

Waagerecht scrollen

Stehen Einträge nebeneinander, scrollt der Bereich seitwärts. Bei wenig Platz bleibt so jede Karte vollständig lesbar, statt umzubrechen.

Frühdienst

06:00 – 14:00

4 Personen

Spätdienst

14:00 – 22:00

3 Personen

Nachtdienst

22:00 – 06:00

2 Personen

Bereitschaft

20:00 – 08:00

1 Person

Springerdienst

10:00 – 18:00

1 Person

Beispiel und Quelltext
schichten.tsx
import { ScrollArea, ScrollBar } from "@neodin-eu/ui";

const schichten = [
  { name: "Frühdienst", zeit: "06:00 – 14:00", personen: "4 Personen" },
  { name: "Spätdienst", zeit: "14:00 – 22:00", personen: "3 Personen" },
  { name: "Nachtdienst", zeit: "22:00 – 06:00", personen: "2 Personen" },
  { name: "Bereitschaft", zeit: "20:00 – 08:00", personen: "1 Person" },
  { name: "Springerdienst", zeit: "10:00 – 18:00", personen: "1 Person" },
];

function Schichten() {
  return (
    <ScrollArea className="w-full max-w-md rounded-md border border-border">
      <div
        role="group"
        aria-label="Schichten des Tages"
        tabIndex={0}
        className="flex gap-3 rounded-sm p-3 outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
      >
        {schichten.map((schicht) => (
          <div
            key={schicht.name}
            className="min-w-40 rounded-md border border-border bg-background p-3"
          >
            <p className="text-sm font-semibold text-foreground">{schicht.name}</p>
            <p className="text-sm text-muted-foreground">{schicht.zeit}</p>
            <p className="text-sm text-muted-foreground">{schicht.personen}</p>
          </div>
        ))}
      </div>
      <ScrollBar orientation="horizontal" />
    </ScrollArea>
  );
}

Barrierefreiheit

  • ScrollArea rendert den Inhalt in einen eigenen Viewport mit overflow-y: scroll beziehungsweise overflow-x: scroll. Der Komponententest prüft, dass der Inhalt darin liegt und die Bildlaufleisten erscheinen.
  • Die Komponente setzt weder eine Rolle noch einen eigenen Tastaturfokus. Der Inhalt selbst bleibt über die üblichen Elemente erreichbar; ein Link oder eine Schaltfläche in der Liste nimmt wie gewohnt am Fokus teil.
  • Mausrad, Touch-Gesten und die Bildlaufleiste bewegen den Inhalt. Wer nur mit der Tastatur arbeitet, erreicht einen nicht fokussierbaren Bereich nicht direkt – halte solche Flächen deshalb kurz, oder mache den Inhalt selbst fokussierbar. In beiden Beispielen trägt die Liste tabIndex={0} und einen aria-label, damit die Tastatur darin scrollen kann.
  • Die Komponente ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von ScrollArea
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von ScrollBar
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–

Siehe auch