Follows the WAI-ARIA Button Pattern.Given the button contains only an icon (i.e. no text content), it is required that a label be provided. This will be both announced to a screen reader and presented visually using a TooltipRenderer.
The button size can be customised via the size prop, which accepts either small, standard (default) or large.
The standard and large sizes both follow the standard text definition from the theme, where standard follows the text size and large follows the line height.
By default, the label is presented as a tooltip on top of the button. However, this can be configured via the tooltipPlacement prop, which accepts either top or bottom. See TooltipRenderer for more information.
The bleed prop allows the background colour to bleed out into the surrounding layout — leaving the button to only take up the space required for the icon itself.
By default, we apply the bleed to the ”transparent” variant, ensuring it does not introduce surrounding white space.