Divider
Divider is a standalone rule between stacked sections or side-by-side items. The line takes a rung of the edge ladder
(tone) or any theme color; thickness and spacing are tokens.Layout & Surfaces
When to use
Use when
- You split groups inside a menu, panel or stacked list without wrapping the rows.
- You separate inline items such as
Buy | Sell— useorientation="vertical". - You need an "or", date or section separator — use
label.
Avoid when
- You separate rows of a
DescriptionList— use itsdividers. - You want a framed box — use a
Paperwith a border. - The break starts a new section — use a heading.
Usage
tone defaults to hairline, thickness to thin and spacing (the margin around the rule) to micro. color
wins over tone; use it only when the rule must carry emphasis.
<Divider /> <Divider tone="strong" /> <Divider color="primary" /> <Divider thickness="regular" spacing="medium" />
Vertical
A vertical divider stretches to the height of its Flex row.
BuySell
<Flex flexDirection="row" gap="small" alignItems="center"> <Text text="Buy" /> <Divider orientation="vertical" /> <Text text="Sell" /> </Flex>
Labeled
label centers text (or a node) on a horizontal rule. It is ignored on a vertical divider.
or
Today
<Divider label="or" />
Accessibility
- A horizontal divider is a native
<hr>, so it has the implicitseparatorrole. - A vertical divider renders
role="separator"witharia-orientation="vertical". - A labeled divider renders
role="separator"; a stringlabelbecomes its accessible name. With a nodelabel, passaria-labelyourself.
Properties
Name
Type
Default
Description
alignContent"center""start""end""between""around""evenly""stretch"nonePacking of wrapped lines / grid tracks on the block axis.
color"main""primary""secondary""tertiary""success""information""warning""danger""primary.dark""primary.action""primary.light""primary.active""secondary.dark""secondary.action""secondary.light""secondary.active""tertiary.dark""tertiary.action""tertiary.light""tertiary.active""success.dark""success.action""success.light""success.active""information.dark""information.action""information.light""information.active""warning.dark""warning.action""warning.light""warning.active""danger.dark""danger.action""danger.light""danger.active""grayscale.0""grayscale.5""grayscale.10""grayscale.20""grayscale.30""grayscale.40""grayscale.50""grayscale.60""grayscale.70""grayscale.80""grayscale.90""grayscale.100""neutral.0""neutral.5""neutral.10""neutral.20""neutral.30""neutral.40""neutral.50""neutral.60""neutral.70""neutral.80""neutral.90""neutral.100""neutral.110""neutral.120""neutral.130""neutral.140""neutral.150""neutral.160""neutral.170""neutral.180""opposite""complementary""baseDark""baseLight""deepDark""deepLight""transparent""muted""surface.canvas""surface.sunken""surface.paper""surface.raised""surface.overlay""surface.scrim""ink.primary""ink.secondary""ink.muted""ink.disabled""edge.strong""edge.hairline""edge.border""wash.hover""wash.pressed""wash.selected"noneTheme color of the line (`primary`, `danger`, `neutral.40`, …). Wins
over `tone` — use it only when the rule must carry emphasis.
containmentstringnoneContainment marker for the `cq` channel: emits
`container-type` (+ `container-name` when the string form carries one,
e.g. `'inline-size card'`). Apply on the immediate wrapper of the
adapting component — NEVER on page-level shells.
cqPartial<Record<ContainerSizeTypes, Partial<Omit<Partial<{ area: string; padding: stringnumber; margin: stringnumber; isHidden: boolean; truncate: boolean; lineClamp: number; pageShell: boolean; ... 14 more ...; transform: string; }>, "containment"> & Partial<...> & SizeFactoryProps & Partial<...>>>>noneContainer-relative **layout** styles per `theme.containerSizes` key.
enableBreakpoint"xs""xl""sm""md""lg"noneForces a breakpoint's prop set to apply regardless of viewport (stories/previews).
ignoreResponsivebooleannoneFully disables the responsive factory (tests / fixed snapshots).
justifyItems"center""start""end""stretch"noneGrid containers: inline alignment of every item in its cell.
labelReactNodenoneText (or node) centered on the rule — the "or" separator. Horizontal
only. A string becomes the accessible name of the separator.
lineClampnumbernoneCaps the text at this many lines and ends the cut with an ellipsis.
The full string stays in the DOM.
orientation"horizontal""vertical"'horizontal'Axis of the rule.
pageShellbooleannoneCenters the element and caps the width at `theme.layout.pageMaxWidth`.
The page shell of a classic centered layout.
placeItems"center""start""end""stretch"noneGrid containers: `place-items` shorthand (block + inline).
spacingSpacingInterface'micro'Breathing room around the rule — vertical margin for a horizontal
divider, horizontal margin for a vertical one.
thickness"none""thin""regular""great""bold"'thin'Line thickness (border-width token).
tone"strong""hairline""border"'hairline'Line weight from the edge ladder.
transformstringnoneCSS `transform` value (e.g. `translate(-50%, -33px)`). Never leaks
to the DOM as an attribute.
viewportMediasPartial<Record<keyof BreakPoint<any>, Partial<Omit<Partial<{ area: string; padding: stringnumber; margin: stringnumber; isHidden: boolean; truncate: boolean; lineClamp: number; pageShell: boolean; ... 14 more ...; transform: string; }>, "containment"> & Partial<...> & SizeFactoryProps & Partial<...>>>>undef...noneViewport-driven **layout** styles per `theme.breakpoints` key.