River breakout tabs

Use RiverBreakoutTabs to pair card-based tabs with a shared visual area on desktop and an accordion pattern on narrower viewports.

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

Examples

Default

Loading

With an optional background and inset media

Loading

Component props

RiverBreakoutTabs Required

NameTypeDefaultDescription
childrenRiverBreakoutTabs.Item[]Includes one required RiverBreakoutTabs.A11yHeading and one or more items
defaultSelectedIndexnumber0Default selected index for uncontrolled mode
selectedIndexnumberSelected index for controlled mode
onChange(selectedIndex: number) => voidCallback called when selected index changes

RiverBreakoutTabs extends the HTML section element and supports all section props.

RiverBreakoutTabs.A11yHeading Required

NameTypeDefaultDescription
childrenReactNodeScreen reader label for the tabs group
as'h2' | 'h3''h3'Semantic heading level for assistive technologies
idstringOptional custom ID used for aria-labelledby relationships

RiverBreakoutTabs.A11yHeading extends the Heading component.

RiverBreakoutTabs.Item Required

NameTypeDefaultDescription
childrenReact.ReactElement[]Must include Heading, Content, and Visual
classNamestringOptional custom class

RiverBreakoutTabs.Item is a structural child component.

RiverBreakoutTabs.Heading Required

NameTypeDefaultDescription
childrenReactNodeItem heading text

RiverBreakoutTabs.Heading extends the Heading component.

RiverBreakoutTabs.Content Required

NameTypeDefaultDescription
childrenReactNodeItem body and action

RiverBreakoutTabs.Content extends the HTML div element and supports all div props.

RiverBreakoutTabs.Icon

NameTypeDefaultDescription
iconIconTypeOcticon to render
color'green' | ...'green'Icon color token

RiverBreakoutTabs.Icon extends the Icon component.

RiverBreakoutTabs.Visual Required

NameTypeDefaultDescription
childrenReact.ReactElementItem visual media
imageBackgroundColor'default' | 'subtle'Optional background around visual

RiverBreakoutTabs.Visual extends River.Visual and supports all River.Visual props.