Skip to main contentCranach Design System

Button

Button

Mit einem Button wird eine Aktion initialisiert. Über die Button-Beschriftung wird angegeben, welche Aktion ausgeführt wird.

Überblick

Button sind anklickbare Elemente, mit denen Aktionen ausgelöst werden. Über den hier zur Verfügung gestellten Button ist es möglich auf verschiedene Weise mit Seiten zu interagieren. Über die Button-Beschriftung wird dabei angegeben, welche Aktion ausgeführt wird.

Wann zu verwenden

Der Button ist für Verlinkung zu anderen Seiten zu benutzten.

Varianten

Für den Button stehen zwei Varianten zur Verfügung

Button variants
VariantPurpose
PrimaryDer primäre Button besteht aus einem ausgefüllten Container und einem Label für aktive und relevante Aktionen
SecondaryDer sekundäre Button besteht aus einem Rahmen und einem Label für zusätzliche nicht aktive Aktionen

Größe

Button variants
VariantPurpose
SmallFor less prominent, and sometimes independent, actions. Tertiary buttons can be used in isolation or paired with a primary button when there are multiple calls to action. Tertiary buttons can also be used for sub-tasks on a page where a primary button for the main and final action is present.
MediumFor the least pronounced actions; often used in conjunction with a primary button. In a situation such as a progress flow, a ghost button may be paired with a primary and secondary button set, where the primary button is for forward action, the secondary button is for “Back”, and the ghost button is for “Cancel”.
LargeFor the least pronounced actions; often used in conjunction with a primary button. In a situation such as a progress flow, a ghost button may be paired with a primary and secondary button set, where the primary button is for forward action, the secondary button is for “Back”, and the ghost button is for “Cancel”.

Formartierung

Anatomy

Der Button besteht aus einem Container und einem Label. Das Label ist dabei ein wichtiges Element, um die Aktion zu kommunizieren.

ArtefactCard anatomy
  1. Container

  2. Label

Code

Dokumentation

Das folgende Storybook zeigt den Button in einer Live Demo. Des Weiteren kann in dieser Testumgebung der Button mit verschiedenen Props und Variante getestet werden.

Code

Button mit Standardwerten

CodeSandbox
<Button />

Beispiel: Button mit der Übergabe aller möglichen props

CodeSandbox
<Button
primary={false}
label={'zur Webseite'}
size={'large'}
href={'https://lucascranach.org'}
backgroundColor={'grey'}
/>

Props

propertypropTypedefaultOptionendescription
labelstringtype your labelBeschriftung des Buttons
primarybooltruetrue, falseAngabe über die Button-Variante
sizestringmediumsmall, medium, largeFestlegung der Größe, Standard
hrefstringhttps://lucascranach.orgDie vollständige URL eines Links
backgroundColorstringnullFarbe des Button-Containers

Inhalt

Label

Button-Beschriftungen sollten die Aktion des Button deutlich anzeigen. Um genügend Kontext bereitzustellen, verwenden die Inhaltsformel {Verb} + {Substantiv} für Schaltflächen, außer bei allgemeinen Aktionen wie “Fertig”, “Schließen”, “Abbrechen”, “Hinzufügen” oder “Löschen”.

Referenzen

Feedback

Helfe uns um diese Komponente/Pattern zu verbessern, indem sie Feedback geben, fragen stelle oder andere Kommentare auf Github hinterlassen.