Anatomy
Content Area A
────────────────────── ← Horizontal divider (thin: 1px / medium: 2px)
Content Area B
Content A │ Content B ← Vertical divider
- Line —
thinis 1 px,mediumis 2 px, color--ds-color-divider-primary - Orientation —
horizontalorvertical
Usage Guidelines
✅ Do
- Use thin dividers to separate list items (light separation without breaking reading flow)
- Use medium dividers to separate independent content sections (between cards and regions)
- Keep divider colors consistent with the overall design system
- Use in moderation — whitespace can also serve as separation
❌ Don't
- Don't overuse dividers — adding one everywhere fragments the page
- Don't use dividers as pure decoration (e.g. gradient colored lines)
- Don't attach interactive elements to dividers
- Don't use dividers as a substitute for proper spacing (margin/padding)
Interaction Behavior
Divider is a purely presentational component with no interactive behavior.
Accessibility
| Requirement | Implementation |
|---|---|
| Semantic role | Use <hr> element or role="separator" |
| Vertical divider | Add aria-orientation="vertical" |
| Contrast | Divider color-to-background contrast ≥ 3:1 |
| Decorative | If used purely for visual decoration, add aria-hidden="true" |

