Komponenten
Scrollbereich (ScrollArea)
StabilLange 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.
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.
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
ScrollArearendert den Inhalt in einen eigenen Viewport mitoverflow-y: scrollbeziehungsweiseoverflow-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 einenaria-label, damit die Tastatur darin scrollen kann. - Die Komponente ist im Komponententest 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 | – |