Button is used for actions, like in forms, while Link is used for destinations, or moving from one page to another.

In special cases where you'd like to use a <a> styled like a Button, use <Button as='a'> and provide an href.

To create a button group, wrap Button elements in the ButtonGroup element. ButtonGroup gets the same props as Box.

Default examples

<Button>Button</Button>
<ButtonDanger>Button Danger</ButtonDanger>
<ButtonOutline>Button Outline</ButtonOutline>
<ButtonPrimary>Button Primary</ButtonPrimary>
<ButtonGroup display='block' my={2}>
  <Button>Button</Button>
  <Button>Button</Button>
  <Button>Button</Button>
</ButtonGroup>
<ButtonTableList>Button Table List </ButtonTableList>

System props

Button and ButtonGroup components get COMMON and LAYOUT system props. Read our System Props doc page for a full list of available props.

Component props

Native <button> HTML attributes are forwarded to the underlying React button component and are not listed below.

Button

ButtonGroup

ButtonGroup has access to the same props as Box

Edit this page on GitHub

2 contributors

Last edited by emplums on May 4, 2020