- Home
- Primitives
- Separator
- Accessibility
Separator
Keyboard, focus, semantic, and consumer responsibilities for Separator.
Accessibility
Accessibility contract
Semantics
- Renders as a `<div>` with `role="separator"` and `aria-orientation` by default.
- When `decorative` is true, renders with `role="none"` and no `aria-orientation`, removing it from the accessibility tree.
- Carries `data-scope="separator"`, `data-part="root"`, and `data-orientation` attributes.
ARIA
- `role="separator"` indicates a visual divider between content regions.
- `aria-orientation="horizontal"` or `aria-orientation="vertical"` specifies the divider orientation. Defaults to horizontal.
- When `decorative` is true, `role="none"` is used instead to hide the element from assistive technologies.
Consumer responsibilities
- Use Separator to divide logically distinct content regions.
- Set `decorative` when the divider is purely visual and does not separate meaningful content sections.
- Use `orientation="vertical"` only when the separator visually divides content side by side.
Not applicable
- keyboard
- Separator is a non-interactive display element with no keyboard interactions.
- focus
- Separator is a non-interactive display element and does not receive focus.
Review status: Draft — not yet reviewed
This contract describes what the primitive guarantees. Consuming products remain responsible for labels, layout, and workflow decisions that affect the final accessibility result.
Automated evidence
Axe scan summary
- Passes
- 10
- Violations
- 0
- Incomplete
- 0
Latest executed scan: Aug 13, 2026, 10:47 PM
Evidence IDs: axe-separator-scan-v1
Automated checks cover only the recorded fixture and do not establish complete accessibility conformance.