SutraUI.Separator (Sutra UI v0.4.0)
View SourceVisually or semantically separates content with a themed one-pixel rule.
Renders a <hr> by default — semantically correct for horizontal dividers and
natively understood by assistive technology. For vertical separators inside
flex containers, set orientation="vertical".
Matches the shadcn/ui Separator API: decorative by default, with an opt-in semantic mode for separators that carry document structure.
Examples
# Horizontal separator (decorative by default)
<.separator />
# Vertical separator — needs a container with an explicit height
<div class="flex h-5 items-center gap-4">
<span>Blog</span>
<.separator orientation="vertical" />
<span>Docs</span>
</div>
# Semantic separator (carries document structure)
<.separator decorative={false} aria-label="End of account section" />
# "Or" divider between two separators
<div class="flex items-center gap-4">
<.separator class="flex-1" />
<span class="text-xs text-muted-foreground">OR</span>
<.separator class="flex-1" />
</div>Attributes
orientation- Direction. One ofhorizontal,vertical. Defaults tohorizontal.decorative- When true (default), the separator is hidden from assistive technology viarole="presentation"andaria-hidden. Set tofalsewhen the separator carries structural meaning.class- Additional CSS classes.id- Optional unique identifier.
Accessibility
- Decorative by default (
role="presentation",aria-hidden="true") — matches shadcn/ui so screen readers don't announce purely visual rules. - Set
decorative={false}when the separator represents a real thematic break in the document; it then exposesrole="separator"andaria-orientation. - Vertical separators that are semantic also set
aria-orientation="vertical".
Summary
Functions
Renders a separator component.
Functions
Renders a separator component.
Examples
<.separator />
<.separator orientation="vertical" />
<.separator decorative={false} aria-label="Section boundary" />Attributes
orientation(:string) - Direction of the separator. Defaults to"horizontal". Must be one of"horizontal", or"vertical".decorative(:boolean) - When true, marks the separator as purely visual. Defaults totrue.class(:any) - Additional CSS classes. Defaults tonil.id(:string) - Optional unique identifier. Defaults tonil.- Global attributes are accepted. Additional HTML attributes. Supports all globals plus:
["aria-label", "aria-labelledby"].