Skip to main content

Installation

npx @soft-ui/cli add separator

Usage

import { Separator } from '@soft-ui/react/separator'

export default function Example() {
  return (
    <div>
      <p>Content above</p>
      <Separator />
      <p>Content below</p>
    </div>
  )
}

Examples

Horizontal

Default orientation creates a horizontal divider.
<div className="space-y-4">
  <p>Section one</p>
  <Separator orientation="horizontal" />
  <p>Section two</p>
</div>

Vertical

Use vertical orientation for side-by-side content.
<div className="flex items-center gap-4 h-8">
  <span>Item 1</span>
  <Separator orientation="vertical" />
  <span>Item 2</span>
  <Separator orientation="vertical" />
  <span>Item 3</span>
</div>

Decorative

By default, separator has role="separator". For purely decorative separators, use decorative prop.
<Separator decorative />

API Reference

Separator

orientation
string
default:"horizontal"
Orientation of the separator: horizontal, vertical.
decorative
boolean
default:false
When true, removes semantic role. Use for purely visual separators.
className
string
Additional CSS classes.

Accessibility

  • Separator has role="separator" by default for semantic meaning
  • Use decorative prop to remove role for purely visual dividers
  • Automatically sets aria-orientation based on orientation prop
  • Does not receive keyboard focus

Design Tokens

Separator uses design tokens for consistent styling:
  • Colors: --color-border-muted
  • Border radius: --radius-max
  • Size: 1px thickness

Build docs developers (and LLMs) love