Skip to main content
Version: Next

button


title: Button Component sidebar_position: 1

Button Component

The Button component is a fundamental UI element used throughout Superset for user interactions.

Basic Usage

The default button with primary styling:

Loading component...

Interactive Example

Loading component...

Props

PropTypeDefaultDescription
buttonStyle'primary' | 'secondary' | 'tertiary' | 'success' | 'warning' | 'danger' | 'default' | 'link' | 'dashed''default'Button style
buttonSize'default' | 'small' | 'xsmall''default'Button size
disabledbooleanfalseWhether the button is disabled
ctabooleanfalseWhether the button is a call-to-action button
tooltipReactNode-Tooltip content
placementTooltipProps['placement']-Tooltip placement
onClickfunction-Callback when button is clicked
hrefstring-Turns button into an anchor link
targetstring-Target attribute for anchor links

Usage

import Button from 'src/components/Button';

function MyComponent() {
return (
<Button
buttonStyle="primary"
onClick={() => console.log('Button clicked')}
>
Click Me
</Button>
);
}

Button Styles

Superset provides a variety of button styles for different purposes:

  • Primary: Used for primary actions
  • Secondary: Used for secondary actions
  • Tertiary: Used for less important actions
  • Success: Used for successful or confirming actions
  • Warning: Used for actions that require caution
  • Danger: Used for destructive actions
  • Link: Used for navigation
  • Dashed: Used for adding new items or features

Button Sizes

Buttons come in three sizes:

  • Default: Standard size for most use cases
  • Small: Compact size for tight spaces
  • XSmall: Extra small size for very limited spaces

Best Practices

  • Use primary buttons for the main action in a form or page
  • Use secondary buttons for alternative actions
  • Use danger buttons for destructive actions
  • Limit the number of primary buttons on a page to avoid confusion
  • Use consistent button styles throughout your application
  • Add tooltips to buttons when their purpose might not be immediately clear