Components

Separator

A visual or semantic divider between content sections.

A horizontal or vertical dividing line. When decorative is false (default), it renders as role="separator" with an appropriate aria-orientation attribute.

Set decorative when assistive technology should ignore the separator.

Anatomy

  • ui.root: Single separator element rendered by as. Direct class also applies here.

Separator has no internal parts. The only styling target is the root element.

Usage

Horizontal separator

Content below the separator.

HomeAboutContact

Examples

Vertical separator

Use vertical orientation between inline or flex items.

<template>
  <div class="flex items-center gap-4">
    <span>Home</span>
    <Separator orientation="vertical" class="h-4" />
    <span>About</span>
  </div>
</template>

Semantic section divider

Use the default semantic separator when the line marks a meaningful content break.

<template>
  <section>
    <h2>Account</h2>
    <p>Profile and authentication settings.</p>
  </section>

  <Separator class="my-8 border-t border-neutral-200" />

  <section>
    <h2>Billing</h2>
    <p>Plan, invoices, and payment method.</p>
  </section>
</template>

Decorative

Use decorative when the separator is purely visual and carries no semantic meaning.

<template>
  <Separator :decorative="true" class="my-divider" />
</template>

API Reference

Props

PropTypeDefaultDescription
orientation"horizontal" | "vertical""horizontal"Direction of the separator line.
decorativebooleanfalseWhen true, renders as role="none" (purely visual).
asstring"div"Root element tag.
uiSeparatorUiClasses for the root element.

UI Options

KeyDescription
rootThe separator element.

Styling Hooks

UI keyCSS classData attrs
rootakaza-separatordata-akaza-orientation