Breakout banner

Use a breakout banner to break up content on longer pages and highlight important information.

Ready to use
import {BreakoutBanner} from '@primer/react-brand'

Examples

Default

Loading

Optional description

Loading

Additional action

Loading

Vertically stacked actions

Loading

Alignment

The content alignment can be changed using the align prop on the root BreakoutBanner. This can be configured to either start or center.

Loading

Leading visual

An accessible label should always be provided for the leading visual.
Loading

Optional background image

Loading

Optional background color

Loading

Component props

BreakoutBanner Required

nametypedefaultrequireddescription
childrenReactNode, ReactNode[]undefinedtrueContent to include within the banner component
align'start', 'center''start'trueThe horizontal positioning of content wihin the banner component
backgroundColor'default', 'subtle', 'string', 'ResponsiveMap''subtle'falseOptional, custom background color
backgroundImageSrc'string', 'ResponsiveMap'undefinedfalseOptional, custom background image
backgroundImagePosition'string', 'ResponsiveMap''center'falseOptional, custom background position
backgroundImageSize'string', 'ResponsiveMap''cover'falseOptional, custom background position size
leadingVisualReactElement, IconundefinedfalseAn optional leading visual that appears before the heading

BreakoutBanner.Heading Required

nametypedefaultrequireddescription
childrenReactNode, ReactNode[]undefinedtrueContent to be displayed inside the BreakoutBanner.Heading component
as'h1', 'h2', 'h3', 'h4', 'h5', 'h6''h3'falseHeading level
size'1', '2', '3', '4', '5', '6''4'falseVisual heading size, irrespective of level

BreakoutBanner.Description

Optional child that can be used to provide additional information.

nametypedefaultrequireddescription
childrenReactNode, ReactNode[]undefinedtrueContent to be displayed inside the banner component

BreakoutBanner.LinkGroup

nametypedefaultrequireddescription
childrenLinkundefinedtrueThe links to be displayed within the group
direction'horizontal', 'vertical', 'ResponsiveMap''horizontal'falsePositioning of the links across x and y axis

All components forward id, className and ref by default

  • CTABanner: For highlighting important information and actions towards the end of a page
  • Bento: For more complex layout needs when presenting multiple content blocks