tuix-button
Der Button für Aktionen, wahlweise mit Icon links und rechts.
tuix-button ist der Aktions-Button des Design Systems. Er rendert einen echten
<button> in seinem Shadow Root, nimmt die Beschriftung aus dem Default-Slot
und meldet Klicks als Event customClick.
Varianten
variant bestimmt die Gewichtung. Es gibt zwei, und es sind dieselben zwei wie
bei jedem Button und Link im System.
Primary
Gefüllt in der Markenfarbe. Einer pro Ansicht: die Aktion, für die die Seite da ist.
Secondary
Mit Kontur. Alles neben einem Primary-Button: Abbrechen, Zurück, sekundäre Aktionen.
Mit Icons
iconLeft und iconRight nehmen jeden Icon-Namen. Die
Farbe des Icons ist nicht einstellbar: sie folgt der Beschriftung, auch beim
Hover, damit der Button in beiden Varianten lesbar bleibt.
Icons rendern mit 24px und fallen unterhalb des Tablet-Breakpoints auf 16px.
Zustände
Disabled
disabled graut den Button aus und verhindert, dass customClick feuert.
Volle Breite
full streckt den Button auf die Breite seines Containers, die übliche Wahl auf
Mobile und in schmalen Formularen.
Dark
Jede Komponente ausser tuix-table hat eine Property
dark, statt ein globales Theme zu lesen. Die Vorschauen dieser Seite folgen
dem Theme, ein Wechsel in der Seitenleiste zeigt also die dunkle Palette.
Klicks
Das Klick-Event heisst customClick, nicht click. Der native Klick bleibt im Shadow Root.
API
Properties
| Property | Attribut | Typ | Standard | Beschreibung |
|---|---|---|---|---|
variant | variant | MainVariant | primary | primary ist gefüllt, secondary hat eine Kontur |
disabled | disabled | boolean | false | Graut den Button aus und blockiert customClick |
dark | dark | boolean | false | Dunkle Palette |
full | full | boolean | false | Auf die Breite des Containers strecken |
iconLeft | iconleft | IconName | Keine | Icon vor der Beschriftung |
iconRight | iconright | IconName | Keine | Icon nach der Beschriftung |
variant, disabled, dark und full werden auf das Attribut gespiegelt,
lassen sich also von aussen stylen und inspizieren. iconLeft und iconRight
nicht: sie werden vom Attribut gelesen, aber nie zurückgeschrieben.
Events
| Event | Detail | Wann |
|---|---|---|
customClick | Keine | Der Button wird geklickt und ist nicht disabled. Bubbelt |
Slots
| Slot | Inhalt |
|---|---|
| default | Die Beschriftung. Sie bekommt automatisch TextSize.Button |
Im Framework
Jedes Beispiel auf dieser Seite wird über die Tabs darüber in Angular, Vue oder React gezeigt. Der vollständige Aufbau je Framework: React und Next.js, Vue, Angular.