Das Button-System definiert die visuellen, semantischen und technischen Regeln für interaktive Aktionen. Dokumentiert werden fünf Buttonrollen, drei Größen, Icon-Anwendungen sowie die Zustände Default, Hover, Focus Visible, Active und Disabled im Light- und Dark-Kontext.

Schnelleinstieg

Buttonsystem

Diese Seite dokumentiert die visuell und technisch freigegebenen Buttonvarianten des Designsystems. Sie unterstützt die Auswahl passender Varianten, die korrekte Umsetzung mit nativen Divi-5-Buttonmodulen und die Qualitätssicherung.

Das Design-System-Paper ist die normative Quelle für Regeln, Architektur und Änderungsverlauf. Diese Referenzseite zeigt die aktuell freigegebene operative Umsetzung.

Status

Freigegebene Referenz

Implementierung

Native Divi 5

Themes

Light und Dark

Größen

S, M und L

Zustände

Default, Hover, Focus Visible, Active und Disabled

Normative Quelle

Design-System-Paper → Button – normative Komponentenspezifikation

Schnelleinstieg

Variante nach Priorität wählen

Die Varianten bilden eine verbindliche Aktionshierarchie. Sie sind keine frei austauschbaren Stiloptionen. Innerhalb einer zusammengehörigen Handlungsgruppe erhält in der Regel nur eine Aktion die höchste visuelle Priorität.

Primary

Die wichtigste Aktion eines Abschnitts oder einer Handlungsgruppe. Grundsätzlich nur einmal auf derselben Entscheidungsebene verwenden.

Secondary

Eine gut sichtbare Alternative oder Ergänzung zur Primary Action mit geringerer visueller Priorität.

Ghost

Eine zurückhaltende Begleit- oder Utility-Aktion, besonders auf ruhigen oder dunklen Flächen.

Tertiary Outline

Eine klar abgegrenzte, aber bewusst zurückgenommene Aktion unterhalb von Primary und Secondary.

Tertiary Link

Eine navigationale oder textnahe Aktion mit der geringsten visuellen Gewichtung.

Hero

Eine kontextbezogene Variante für prominente Einstiegs- und Introbereiche. Hero ist keine zusätzliche allgemeine Hierarchiestufe.

Referenz und Umsetzung

1. Buttonvarianten und Größen

Das Button-System umfasst fünf semantische Rollen und drei Größen. Die Rolle bestimmt visuelle Hierarchie und Verwendung, die Größe bestimmt den Platzbedarf und den geeigneten Anwendungskontext. Alle Rollen stehen für Light- und Dark-Kontexte zur Verfügung; die Größe M bildet den Standard für die meisten Anwendungen.

Pro Entscheidungsbereich wird höchstens eine Primary Action eingesetzt. Secondary, Ghost und die beiden Tertiary-Varianten ordnen weitere Aktionen nach abnehmender visueller Priorität. Die Wahl der HTML-Semantik richtet sich nach dem Verhalten: Navigation wird als Link, eine funktionale Aktion als Button umgesetzt.

1.1 Größenlogik

Die Größen S, M und L verwenden dieselben Rollen und Zustandsmodelle. Unterschiede bestehen ausschließlich in Typografie, Innenabständen und dem daraus resultierenden Platzbedarf. Größe M ist der Standard. S ist für dichte Oberflächen vorgesehen, L für hervorgehobene CTA- und Hero-Anwendungen.

Button S

Kompakt

Für dichte Bedienoberflächen wie Filterleisten, Toolbars und Verwaltungsansichten. Nicht als Standardgröße für zentrale Handlungsaufforderungen. S ist eine kompakte Kontextgröße und nicht automatisch die Mobile-Variante.

Button M

Standard

Für Formulare, Inhaltsbereiche, Cards, Dialoge und die meisten regulären Aktionen.

Button L

Prominent

Für hervorgehobene Handlungsaufforderungen in Hero-, CTA- und vergleichbaren Schwerpunktbereichen. Nicht inflationär verwenden.

1.2 Native Buttonrollen und Größen

Die folgenden Referenzflächen zeigen alle fünf Buttonrollen in den Größen S, M und L. Jede Größe wird im Light- und Dark-Kontext einschließlich der tokenbasierten Disabled-Zustände dokumentiert.

Native Buttons Light S

Native Standardimplementierung der fünf Buttonrollen in Größe S auf einer hellen Fläche. Primary kennzeichnet die wichtigste Aktion, Secondary eine wichtige Alternative und Ghost eine visuell nachgeordnete Buttonaktion. Tertiary Link und Tertiary Outline bilden die leichteste Interaktionsebene für Navigation und kompakte UI-Funktionen.

Native Buttons Dark S

Native Standardimplementierung der fünf Buttonrollen in Größe S auf einer dunklen Fläche. Die Varianten verwenden dieselbe Geometrie wie im Light-Kontext, aber kontextspezifische Text-, Border-, Zustands- und Fokusfarben. Primary bleibt auf dunklen Flächen ohne Elevation.

Native Buttons Light M

Native Standardimplementierung der fünf Buttonrollen in Größe M auf einer hellen Fläche. Primary kennzeichnet die wichtigste Aktion, Secondary eine wichtige Alternative und Ghost eine visuell nachgeordnete Buttonaktion. Tertiary Link und Tertiary Outline bilden die leichteste Interaktionsebene für Navigation und kompakte UI-Funktionen.

Native Buttons Dark M

Native Standardimplementierung der fünf Buttonrollen in Größe M auf einer dunklen Fläche. Die Varianten verwenden dieselbe Geometrie wie im Light-Kontext, aber kontextspezifische Text-, Border-, Zustands- und Fokusfarben. Primary bleibt auf dunklen Flächen ohne Elevation.

Native Buttons Light L

Native Standardimplementierung der fünf Buttonrollen in Größe L auf einer hellen Fläche. Primary kennzeichnet die wichtigste Aktion, Secondary eine wichtige Alternative und Ghost eine visuell nachgeordnete Buttonaktion. Tertiary Link und Tertiary Outline bilden die leichteste Interaktionsebene für Navigation und kompakte UI-Funktionen.

Native Buttons Dark L

Native Standardimplementierung der fünf Buttonrollen in Größe L auf einer dunklen Fläche. Die Varianten verwenden dieselbe Geometrie wie im Light-Kontext, aber kontextspezifische Text-, Border-, Zustands- und Fokusfarben. Primary bleibt auf dunklen Flächen ohne Elevation.

1.3 Buttons mit Icons

Icons ergänzen die Buttonbeschriftung, wenn sie Bedeutung, Richtung oder Ergebnis einer Aktion schneller erfassbar machen. Die sichtbare Textbeschriftung bleibt der primäre Bedeutungsträger und bildet grundsätzlich auch den zugänglichen Namen des Buttons.

Richtungs- und Fortschrittsicons stehen in Schreibrichtung nach der Beschriftung. Objekt-, Status- und Aktionsicons stehen in der Regel vor der Beschriftung. Eine abweichende Position ist nur zulässig, wenn sie die Bedeutung oder Bedienlogik im konkreten Kontext verständlicher macht.

Bei Buttons mit sichtbarer Textbeschriftung wird ein bedeutungsgleiches Icon assistiven Technologien nicht zusätzlich als eigenständige Information ausgegeben. Icon-only-Buttons benötigen dagegen immer eine eindeutige zugängliche Bezeichnung.

Die Buttonrolle richtet sich nach der Priorität im jeweiligen Kontext und nicht allein nach dem Verb oder Icon: „Speichern“ kann je nach Oberfläche Primary, Secondary oder Ghost sein. Die Beispiele zeigen daher typische Anwendungen, aber keine unveränderliche Zuordnung eines Verbs zu einer Rolle.

Die Referenzen werden in der normativen Standardgröße M und im Light-Kontext gezeigt. Größe, Farbkontext, Zustände und Fokusverhalten werden aus dem jeweiligen Basis-Buttonpreset abgeleitet. Tertiary Actions erhalten Icons nur in begründeten Fällen, etwa für Downloads, externe Links, Aufklappen, Zurücknavigation oder Filterfunktionen.

1.4 Tertiary Actions und Semantik

Tertiary Actions bilden die leichteste Interaktionsebene des Buttonsystems. Tertiary Link wird für nachgeordnete Navigation verwendet, etwa für weiterführende Inhalte, Detailansichten, Downloads oder Sprungziele. Das Element muss technisch als Link ausgegeben werden, wenn es zu einer anderen Ressource oder Position navigiert.

Tertiary Outline erzeugt durch die sichtbare Border mehr Struktur und eignet sich für nachgeordnete Funktionen wie das Öffnen von Filtern oder Dialogen, das Umschalten einer Ansicht und kompakte UI-Steuerungen. Löst das Element eine Funktion in der aktuellen Ansicht aus, muss es technisch als Button umgesetzt werden.

Die visuelle Variante allein legt die HTML-Semantik nicht fest. Navigation verwendet einen Link, funktionale Interaktion einen Button. Die hier gezeigten Beispiele „Mehr lesen“ und „Filter anzeigen“ verdeutlichen diese beiden Einsatzbereiche. Das hinterlegte Platzhalterziel dient ausschließlich der Darstellung auf der Dokumentationsseite.

2. Button-Gruppe im Anwendungskontext

Button-Gruppen ordnen zusammengehörige Aktionen nach ihrer visuellen und semantischen Priorität. Die wichtigste Aktion steht in Schreibrichtung zuerst. Auf kleinen Viewports werden die Buttons vertikal angeordnet und nutzen die verfügbare Breite.

2.1 Dark-Hero-Anwendung

Die Dark-Hero-Anwendung zeigt Primary und Ghost als typische Kombination aus Haupt- und Alternativaktion. Beide Buttons werden als native Divi-5-Buttonmodule innerhalb einer gemeinsamen Divi Group umgesetzt.

Digitale Erlebnisse mit klarer Strategie und starkem Design

Ich entwickle Websites und digitale Systeme, die Inhalte überzeugend vermitteln, Orientierung schaffen und langfristig wartbar bleiben.

2.2 Umsetzungsregeln

Die Anordnung wird über das Preset GRP | Button Group gesteuert. Auf Desktop ordnet die Group zusammengehörige Aktionen horizontal mit tokenbasiertem Gap an und erlaubt bei Bedarf einen kontrollierten Umbruch. Auf kleinen Viewports kann die Anordnung abhängig vom Anwendungskontext vertikal wechseln.

Buttons verwenden standardmäßig eine inhaltsabhängige Breite. Eine vollbreite oder gestreckte Darstellung ist eine bewusst definierte Kontextvariante, beispielsweise für hervorgehobene Hero- oder CTA-Kompositionen. Reihenfolge, Gap, Umbruch, Ausrichtung und gegebenenfalls Streckung werden auf Ebene der Button-Group geregelt. Individuelle Außenabstände an den enthaltenen Buttons sind nicht vorgesehen.

3. Button oder Link?

Navigation verwendet einen Link. Eine Aktion innerhalb der aktuellen Oberfläche verwendet ein echtes Button-Element. Die visuelle Buttondarstellung allein bestimmt nicht die Semantik.

Native Divi-5-Buttonmodule mit gesetzter URL werden als Links ausgegeben. Sie eignen sich für Seitenziele, Sprungziele, Downloads und externe Angebote. Für Aktionen wie Speichern, Filtern, Absenden, Öffnen oder Bestätigen ist ein semantisch echtes Button-Element erforderlich.

Link verwenden

  • andere Seite öffnen
  • zu einem Seitenabschnitt springen
  • Download aufrufen
  • externes Ziel öffnen

Button verwenden

  • Formular absenden
  • Auswahl speichern
  • Filter anwenden
    • Dialog öffnen oder schließen
    • Aktion bestätigen

Ein Link besitzt keinen nativen Disabled-Zustand. Als Button gestaltete Links benötigen deshalb eine kontrollierte Simulation. Disabled ersetzt weder Validierung noch Berechtigungs- oder Geschäftslogik.

4. Native Divi 5 Button State Matrix

Die folgende State-Matrix dokumentiert die fünf nativen Divi-5-Buttonrollen Primary, Secondary, Ghost, Tertiary Link und Tertiary Outline im Light- und Dark-Kontext. Für jede Rolle werden Default, Hover, Focus Visible, Active und Disabled als statische Referenz dargestellt. Die produktiven Zustände werden aus den jeweiligen Buttonpresets abgeleitet; zusätzliche CSS-OGPs dienen ausschließlich der dauerhaften Darstellung interaktiver Zustände auf dieser Dokumentationsseite.

4.1 Light Mode

Im Light Mode werden die Buttonzustände auf dem globalen hellen Background geprüft. Dabei stehen die Lesbarkeit der Textfarben, die Erkennbarkeit von Borders sowie die visuelle Trennung zwischen verfügbaren, interaktiven und deaktivierten Elementen im Mittelpunkt.

Der Hover State signalisiert die mögliche Interaktion durch eine kontrollierte Veränderung von Background, Text und gegebenenfalls Border. Der Focus Visible State verwendet einen kontrastreichen Accent-Cool-Ring außerhalb der Komponentenbegrenzung. Der Active State verstärkt die visuelle Rückmeldung während der Aktivierung. Der Disabled State reduziert die visuelle Priorität, muss aber weiterhin lesbar und eindeutig als Bestandteil der Benutzeroberfläche erkennbar bleiben.

Primary M

Secondary M

Ghost M

Tertiary Link M

Tertiary Outline M

4.2 Dark Mode

Im Dark Mode werden die Buttonzustände auf dem globalen Dark Background geprüft. Die Komponenten behalten ihre semantische Rolle, verwenden jedoch angepasste Text-, Border- und State-Farben, damit sie auf dunklen Flächen ausreichend sichtbar bleiben.

Die Hierarchie wird im Dark Mode primär über Farbkontrast, Borders und transparente State-Layer erzeugt. Button-Shadows werden standardmäßig nicht eingesetzt. Hover und Active verwenden abgestufte transparente Component Layer. Der Focus Visible State verwendet einen helleren Accent-Cool-Ring. Disabled States werden bewusst zurückgenommen, ohne vollständig mit dem Hintergrund zu verschmelzen.

Primary M

Secondary M

Ghost M

Tertiary Link M

Tertiary Outline M

4.3 Technische Testdarstellung

Hinweis zur Testdarstellung: Die Light- und Dark-Matrizen dokumentieren die native Divi-5-Implementierung der Buttonzustände. Hover, Active und Focus Visible werden für die dauerhafte Vergleichsdarstellung über variantenspezifische CSS-OGPs statisch abgebildet. Diese Vorschauzustände dienen ausschließlich der Design-System-Dokumentation; die produktiven Zustände werden weiterhin durch die jeweiligen Button-Modulpresets gesteuert. Die statischen Hover-, Focus-Visible- und Active-Vorschauen werden mit tabindex="-1" und aria-hidden="true" aus Tastaturreihenfolge und Accessibility-Baum entfernt. Disabled wird über Attribute sowie allgemeine und variantenspezifische CSS-OGPs semantisch und tokenbasiert umgesetzt.

 

Die statische Darstellung ersetzt keine interaktive Prüfung. Hover und Active müssen zusätzlich mit Zeiger beziehungsweise Touch geprüft werden. Focus Visible wird per Tastaturnavigation getestet.