Zum Inhalt springen
Dokumentation

Komponenten

Seitenverhältnis (AspectRatio)

Stabil

Ein Rahmen mit festem Verhältnis von Breite zu Höhe – für Diagramme, Kacheln und Vorschauen.

Ein Seitenverhältnis hält Breite und Höhe in einer festen Beziehung: Ein Diagramm bleibt im Verhältnis 16:9, eine Stationskachel quadratisch – auch wenn sich die Breite der Spalte ändert. Der Inhalt springt beim Laden nicht.

Wann verwenden

  • Für Diagramme und Kennzahlenflächen, die ihre Form behalten sollen, während sich der Platz ändert.
  • Für Kacheln in einem Raster, die alle gleich hoch wirken sollen.
  • Für Vorschauen von Dokumenten oder Fotos, bei denen ein festes Format erwartet wird.

Wann nicht

  • Für Fließtext ist ein festes Verhältnis falsch: Text braucht die Höhe, die er zum Lesen benötigt.
  • Für Tabellen und Listen, deren Höhe vom Inhalt abhängt, bringt das Verhältnis nur leeren Raum oder abgeschnittenen Inhalt.
  • Für Bilder mit festen Maßen genügt width und height am Bild; das Verhältnis entsteht dann von selbst.

Aufbau

AspectRatio bekommt das Verhältnis als Zahl – 16 / 9 für Breitbild, 1 für ein Quadrat. Die Komponente reserviert die Höhe über die Breite und legt den Inhalt darüber; er kann die Fläche mit h-full vollständig füllen.

Bettenbelegung Station 3

Belegte Betten pro Tag, von 24

  • Mo: 18 von 24 Betten belegt
  • Di: 20 von 24 Betten belegt
  • Mi: 17 von 24 Betten belegt
  • Do: 21 von 24 Betten belegt
  • Fr: 19 von 24 Betten belegt
  • Sa: 14 von 24 Betten belegt
  • So: 12 von 24 Betten belegt
Beispiel und Quelltext
belegung.tsx
import { AspectRatio } from "@neodin-eu/ui";

const werte = [
  { tag: "Mo", betten: 18 },
  { tag: "Di", betten: 20 },
  { tag: "Mi", betten: 17 },
  { tag: "Do", betten: 21 },
  { tag: "Fr", betten: 19 },
  { tag: "Sa", betten: 14 },
  { tag: "So", betten: 12 },
];

function Belegung() {
  return (
    <AspectRatio
      ratio={16 / 9}
      className="w-full max-w-lg rounded-md border border-border bg-background"
    >
      <div className="flex h-full flex-col justify-between p-4">
        <div>
          <p className="text-sm font-semibold text-foreground">Bettenbelegung Station 3</p>
          <p className="text-sm text-muted-foreground">Belegte Betten pro Tag, von 24</p>
        </div>
        <ul className="flex h-28 items-end gap-2">
          {werte.map((wert) => (
            <li key={wert.tag} className="flex h-full flex-1 flex-col justify-end gap-1">
              <div
                aria-hidden="true"
                className="w-full rounded-sm bg-primary"
                style={{ height: `${(wert.betten / 24) * 100}%` }}
              />
              <span aria-hidden="true" className="text-center text-xs text-muted-foreground">
                {wert.tag}
              </span>
              <span className="sr-only">
                {wert.tag}: {wert.betten} von 24 Betten belegt
              </span>
            </li>
          ))}
        </ul>
      </div>
    </AspectRatio>
  );
}

Quadratische Kacheln

Mit ratio={1} entstehen gleich hohe Kacheln, etwa für Stationen in einer Übersicht. Auf schmalen Bildschirmen bleibt das Verhältnis erhalten, die Kachel wird nur kleiner.

S3Station 3 · Innere Medizin
Beispiel und Quelltext
kachel.tsx
import { AspectRatio } from "@neodin-eu/ui";

function Kachel() {
  return (
    <AspectRatio ratio={1} className="w-48 rounded-md border border-border bg-muted">
      <div className="flex h-full flex-col items-center justify-center gap-1 p-4 text-center">
        <span className="text-2xl font-semibold text-foreground">S3</span>
        <span className="text-sm text-muted-foreground">Station 3 · Innere Medizin</span>
      </div>
    </AspectRatio>
  );
}

Barrierefreiheit

  • AspectRatio rendert ein div ohne eigene Rolle und ohne Tastaturfokus. Die Fläche dient allein der Form; die Bedeutung kommt aus dem Inhalt.
  • Der Inhalt liegt in einem eigenen, absolut positionierten Bereich über der reservierten Höhe. Der Komponententest prüft, dass die Höhe über den Prozentwert der Breite reserviert wird und die Kinder gerendert werden.
  • Rein schmückende Grafiken bekommen aria-hidden="true"; Werte, die nur visuell dargestellt werden, brauchen zusätzlich Text – im Beispiel steht die Bettenzahl als unsichtbarer Text neben jedem Balken.
  • Die Komponente ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von AspectRatio
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–

Siehe auch