Komponenten
Schaltfläche (Button)
StabilPrimä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
destructiveund 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,CheckboxoderTabsbesser.
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.
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.
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.
import { Button } from "@neodin-eu/ui";
<Button>Speichern</Button>Barrierefreiheit
Buttonrendert ein nativesbutton-Element. Damit gelten die Tastaturregeln des Browsers:Tabfokussiert,EnterundLeertastelö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-labelan 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.
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | false | Nein | Render the child element instead of a `<button>` (Radix Slot). |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| size | "default" | "sm" | "lg" | "icon" | null | – | Nein | Height and padding preset; all presets follow the density (`--control-h`). |
| variant | "link" | "default" | "secondary" | "destructive" | "outline" | "ghost" | null | – | Nein | Visual style of the button; defaults to `"default"`. |