Separator
A line that separates content.
There is no WAI-ARIA APG pattern for static separators. Separator renders a <div> with the separator role, because <hr> cannot express a vertical orientation.
leve-ui
Headless UI for Qwik.
DocsGitHubnpm
import { component$, useStyles$ } from '@builder.io/qwik';
import { Separator } from '@leve-ui/separator';
import styles from './default.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<div class="separator-default-card">
<p class="separator-default-title">leve-ui</p>
<p class="separator-default-text">Headless UI for Qwik.</p>
<Separator.Root class="separator-default" />
<div class="separator-default-links">
<span>Docs</span>
<span>GitHub</span>
<span>npm</span>
</div>
</div>
);
});.separator-default-card {
width: 240px;
font-family: inherit;
}
.separator-default-title {
margin: 0;
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.separator-default-text {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}
.separator-default {
height: 1px;
margin: 12px 0;
background: light-dark(#e2e8f0, #ffffff1f);
}
.separator-default-links {
display: flex;
gap: 12px;
font-size: 13px;
color: light-dark(#0f172a, #ffffff);
}Installation#
Install the individual package, or use @leve-ui/core to get every component at once:
pnpm add @leve-ui/separatornpm install @leve-ui/separatoryarn add @leve-ui/separatorbun add @leve-ui/separatorpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/coreAnatomy#
import { Separator } from '@leve-ui/separator'; // or '@leve-ui/core'
<Separator.Root />
| Part | Element | Description |
|---|---|---|
Separator.Root | <div> | The separator. Has no children. |
Examples#
Decorative#
decorative hides a purely visual separator from assistive technologies with role="none".
leve-ui
Headless UI for Qwik.
DocsGitHubnpm
import { component$, useStyles$ } from '@builder.io/qwik';
import { Separator } from '@leve-ui/separator';
import styles from './decorative.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<div class="separator-decorative-card">
<p class="separator-decorative-title">leve-ui</p>
<p class="separator-decorative-text">Headless UI for Qwik.</p>
{/* Purely visual: hidden from assistive technology */}
<Separator.Root decorative class="separator-decorative" />
<div class="separator-decorative-links">
<span>Docs</span>
<span>GitHub</span>
<span>npm</span>
</div>
</div>
);
});.separator-decorative-card {
width: 240px;
font-family: inherit;
}
.separator-decorative-title {
margin: 0;
font-size: 14px;
font-weight: 600;
color: light-dark(#0f172a, #ffffff);
}
.separator-decorative-text {
margin: 0;
font-size: 13px;
color: light-dark(#475569, #c9ddf0);
}
.separator-decorative {
height: 1px;
margin: 12px 0;
background: light-dark(#e2e8f0, #ffffff1f);
}
.separator-decorative-links {
display: flex;
gap: 12px;
font-size: 13px;
color: light-dark(#0f172a, #ffffff);
}Vertical#
orientation="vertical" separates items in a row.
DocsGitHub
import { component$, useStyles$ } from '@builder.io/qwik';
import { Separator } from '@leve-ui/separator';
import styles from './vertical.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<div class="separator-vertical-row">
<span>Docs</span>
<Separator.Root orientation="vertical" class="separator-vertical" />
<span>GitHub</span>
</div>
);
});.separator-vertical-row {
display: flex;
align-items: center;
gap: 12px;
font-family: inherit;
font-size: 13px;
color: light-dark(#0f172a, #ffffff);
}
.separator-vertical {
width: 1px;
height: 16px;
align-self: center;
background: light-dark(#e2e8f0, #ffffff1f);
}API Reference#
Root#
| Prop | Default | Type |
|---|---|---|
| orientation | 'horizontal' | 'horizontal' | 'vertical' The orientation of the separator. |
| decorative | false | boolean Hides the separator from assistive technology ( |
Also accepts all <div> attributes.
| Data attribute | Value |
|---|---|
data-leve-separator | Always present |
data-orientation | "horizontal" | "vertical" |
data-orientation is rendered even when decorative is set, so the same styles work for both.
Accessibility#
Separator.Rootrendersrole="separator", andaria-orientation="vertical"when vertical. Horizontal is the default of the role, soaria-orientationis not rendered for it.- With
decorative, it rendersrole="none"and noaria-orientation. Use it when the separator does not divide meaningful sections. - Separator is not focusable and has no keyboard interaction.