Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

TokenDescription
displayNameDisplay name shown in the structure panel.
contextJsonSchemaDefines schema for context data used with the button.
textTranslationsSets the button text with multi-language support.
sizeDetermines button size: medium, large, or extra_large.
typeSpecifies visual style: primary, secondary, or ghost.
showTooltipControls whether tooltip is displayed on hover.
tooltipTextTranslationsTooltip text with multi-language support.
iconRightIcon displayed on the right side of button text.
iconLeftIcon displayed on the left side of button text.
tooltipPlacementPosition of tooltip: top, bottom, left, right.
tooltipDelayDelay in ms before tooltip appears.
widthAutoAdjusts width automatically to content if true.
heightAutoAdjusts height automatically to content if true.
paddingClassConfigures spacing around button via CSS classes.
eventsConfigures component events.
ON_BUTTON_CLICK (Events)Event triggered when button is clicked.
ON_GLOBAL_PARAMETERS_CHANGE (Events)Event triggered when global parameters affecting the button change.
ON_INIT (Events)Event triggered when the button is initialized.
ON_DESTROY (Events)Event triggered when the button is removed from DOM.
authorizationDisableDefines policy set for enabling or disabling button.
visibilityPolicySetIdDefines policy set for button visibility.
displayConditionsRules for showing or hiding button.
idUnique identifier for programmatic access.
dataTestIdTesting hook ID for automated tests.
enableAsHotspotEnables button as hotspot for guided tours.
guidedTourHotSpotTitleTitle for guided tour hotspot, with translations.
guidedTourHotSpotDescriptionDescription for guided tour hotspot, with translations.

...

  • authorizationDisable – Specifies a policy set that determines whether the button should be enabled or disabled based on user permissions. For example, setting to "editingPermissions" would disable the button for users who don't have editing permissions, while still showing it in the interface.
  • visibilityPolicySetId – Determines the visibility of the component based on specified policy sets. For example, setting to "adminActions" makes the button visible only to users with administrator privileges.
  • Figma: https://www.figma.com/design/yck1tcUXgdQ5aYX6iUAwrO/GE---Astronaut-Design-System?node-id=11523-163008&t=iosNC2AkSTGs5lMh-1
  • Live style guide: https://e1-dev.k8s.myapp.de/live-style-guide/id2/1-button

Guidelines

Hierarchy

  • Buttons follow a visual hierarchy that reads right → left.
  • Primary is the most important action and should stand out (e.g., Save, Submit, Apply).
  • Danger (semantic) is for destructive actions; a lone, strongly destructive primary (e.g., Delete) may use the semantic style.
  • Secondary covers all other, less prominent actions (e.g., Copy, Cancel).
  • Negative path is a non-committing alternative; treat it as a separate, lower-emphasis option.

...