Separator
Separator divides adjacent content without adding a new container. Choose it for a real boundary in a reading flow or toolbar; use spacing alone when there is no relationship to communicate.
Examples
A horizontal content break
The default is a native horizontal rule. Use it where the content changes topic or section, not to decorate every gap between nearby elements.
A labelled alternative
label creates a horizontal separator with text at its centre, which works well for an alternate
path such as a different sign-in method.
A vertical toolbar divider
Set orientation="vertical" for a compact divider between toolbar sections. Give it an accessible
name only when the separation itself communicates something useful.
When to use
Use Separator to communicate a boundary between related groups of content or controls.
Reach for something else when:
- Only whitespace is needed — use Stack, Grid or the parent component's gap rather than a line that suggests a division.
- The content needs a named, navigable section — use a heading and semantic sectioning instead of a separator.
- The UI is a set of selectable views — use Tabs rather than lines that do not provide a control.
Accessibility
- The default horizontal form is an
<hr>, which carries the native horizontal separator semantics. orientation="vertical"renders aspanwithrole="separator"andaria-orientation="vertical".- A
labelrenders adivwithrole="separator"and is always horizontal, regardless oforientation. - The component does not decide whether a divider is decorative. For a purely visual line, pass
aria-hidden="true"; otherwise leave the emitted semantic separator available to assistive technology.
API and code
| Name | Type | Required | Description |
|---|---|---|---|
orientation | 'horizontal' | 'vertical' | — | Separator direction. Default: `"horizontal"`. |
label | ReactNode | — | Centered label, such as `"or"`. Always renders a horizontal separator. |
Use the element that matches the separator's meaning, then apply the matching Lyra class:
<hr class="lyra-separator" />
<span
class="lyra-separator lyra-separator--vertical"
role="separator"
aria-orientation="vertical"
></span>
<div class="lyra-separator--label" role="separator">or continue with</div><lyra:separator> Generated from lyra-ds/blade v0.10.0.
| Prop | Default | Required | Example values |
|---|---|---|---|
orientation | 'horizontal' | — | vertical |
<lyra:separator orientation="horizontal">
<x-slot:label>Danger zone</x-slot:label>
</lyra:separator>