Separator
A visual divider that separates content with support for vertical and horizontal orientations.
Anatomy
Import and assemble the component:
1import { Separator } from '@raystack/apsara'23<Separator />
Usage
Which way the line runs, where its ends sit, and what color it takes.
Orientation
horizontal (the default) draws a full-width rule between stacked content. vertical draws a rule between items in a row, and needs a parent with a set height to draw against.
1<Flex direction="column" gap={5} style={{ width: "400px" }}>2 <Text>Above</Text>3 <Separator />4 <Flex gap={5} align="center" style={{ height: "24px" }}>5 <Text>Left</Text>6 <Separator orientation="vertical" />7 <Text>Right</Text>8 </Flex>9</Flex>
Variant
full (the default) runs the rule edge to edge. middle insets both ends from the container edges.
1<Flex direction="column" gap={9} align="center" style={{ width: "400px" }}>2 <Separator variant="full" />3 <Separator variant="middle" />4</Flex>
Color
primary is the default. secondary and tertiary draw a stronger line, and emphasis the strongest. accent, attention, danger and success carry meaning.
1<Flex direction="column" gap={9} align="center" style={{ width: "400px" }}>2 <Separator color="primary" />3 <Separator color="secondary" />4 <Separator color="tertiary" />5 <Separator color="emphasis" />6 <Separator color="accent" />7 <Separator color="attention" />8 <Separator color="danger" />9 <Separator color="success" />10</Flex>
API Reference
Renders a visual divider between content sections.
Prop
Type
Slots
Every rendered part carries a stable data-slot attribute for styling and testing:
| Slot | Element |
|---|---|
separator | The separator element |
Accessibility
- Uses
role="separator"andaria-orientationby default so the divider is announced and oriented correctly. - Pass
decorativewhen the separator is purely visual (for example between icons in a toolbar). It then renders withrole="presentation"andaria-hidden="true"so assistive tech skips it.