Zum Inhalt springen
Dokumentation

Komponenten

Schaltfläche (Button)

Stabil

Primäre und sekundäre Aktionen – Varianten, Größen und der gesperrte Zustand.

Eine Schaltfläche löst genau eine Aktion aus: speichern, bestätigen, abbrechen. Sie trägt die Beschriftung der Aktion in der Sprache der Anwendung – „Dienstplan veröffentlichen“ statt „OK“.

Wann verwenden

  • Für die wichtigste Aktion einer Ansicht gibt es genau eine primäre Schaltfläche – etwa „Speichern“ im Formular.
  • Für Nebenwege genügen sekundäre, Outline- oder Ghost-Varianten.
  • Destruktive Aktionen wie „Ticket schließen“ tragen die Variante destructive und brauchen in der Regel eine Rückfrage.

Wann nicht

  • Für Navigation sind Links die richtige Wahl, nicht Schaltflächen. Ein Link lässt sich in einem neuen Tab öffnen, eine Schaltfläche nicht.
  • Mehrere primäre Schaltflächen nebeneinander konkurrieren um die Aufmerksamkeit. Eine davon ist die Hauptaktion.
  • Für reine Umschaltungen passen Switch, Checkbox oder Tabs besser.

Varianten

Die Variante bestimmt das Gewicht: default ist die Hauptaktion, secondary die ruhige Alternative innerhalb einer Gruppe, outline grenzt sich über den Rahmen ab, ghost bleibt ohne Fläche für dichte Bereiche und link sieht aus wie ein Link, bleibt aber eine Schaltfläche.

Beispiel und Quelltext
varianten.tsx
import { Button } from "@neodin-eu/ui";

function Varianten() {
  return (
    <div className="flex flex-wrap items-center gap-3">
      <Button>Speichern</Button>
      <Button variant="secondary">Entwurf speichern</Button>
      <Button variant="outline">Abbrechen</Button>
      <Button variant="ghost">Details</Button>
      <Button variant="destructive">Ticket schließen</Button>
      <Button variant="link">Richtlinie öffnen</Button>
    </div>
  );
}

Größen

sm passt in Tabellen und Werkzeugleisten, default ist die Standardhöhe für Formulare, lg trägt Seitenaktionen. icon ist für quadratische Schaltflächen mit einem einzelnen Symbol gedacht – der zugängliche Name kommt dann aus aria-label.

Beispiel und Quelltext
groessen.tsx
import { Button } from "@neodin-eu/ui";

function Groessen() {
  return (
    <div className="flex flex-wrap items-center gap-3">
      <Button size="sm">Kleine Aktion</Button>
      <Button size="default">Standard</Button>
      <Button size="lg">Seitenaktion</Button>
      <Button size="icon" aria-label="Dienstplan drucken">
        ⤓
      </Button>
      <Button disabled>Gesperrt</Button>
    </div>
  );
}

Baukasten

Stell Variante, Größe und Zustand ein. Die Vorschau aktualisiert sich sofort, darunter steht der passende JSX-Code zum Kopieren – ohne die Standardwerte, die ohnehin gelten.

Code
import { Button } from "@neodin-eu/ui";

<Button>Speichern</Button>

Barrierefreiheit

  • Button rendert ein natives button-Element. Damit gelten die Tastaturregeln des Browsers: Tab fokussiert, Enter und Leertaste lösen die Aktion aus.
  • Der Fokus ist sichtbar (Fokusring über focus-visible), auch im Dunkelmodus.
  • Ein gesperrter Button trägt das disabled-Attribut: Er ist nicht fokussierbar und löst auch bei einem Klick keine Aktion aus. Das ist im Komponententest abgesichert.
  • Die Beschriftung ist der zugängliche Name. Reicht ein Symbol allein, gehört ein aria-label an die Schaltfläche.

Props

Die Tabelle wird aus den Typen der Bibliothek erzeugt (pnpm --filter site props:generate) und kann deshalb nicht von der Implementierung abweichen. Nicht aufgeführt sind die Attribute des nativen button-Elements – sie funktionieren unverändert.

Props von Button
PropTypStandardPflichtBeschreibung
asChildbooleanfalseNeinRender the child element instead of a `<button>` (Radix Slot).
classNamestring–Nein–
disabledboolean–Nein–
size"default" | "sm" | "lg" | "icon" | null–NeinHeight and padding preset; all presets follow the density (`--control-h`).
variant"link" | "default" | "secondary" | "destructive" | "outline" | "ghost" | null–NeinVisual style of the button; defaults to `"default"`.