Skip to main content
ShadcnUI
Navigation

Separator

A native hr for semantic separation or an aria-hidden decorative boundary.

When to use it. Use it when its native document or form semantics match the caller-owned requirement.

Native baseline The caller decides whether a boundary is meaningful. Content order remains intact without CSS. Exact fallback No script is required. Without package CSS or an optional feature, content and native controls remain available in source order.

How it works

  • <.separator> The caller decides whether a boundary is meaningful. Content order remains intact without CSS.
  • package CSS Package CSS applies scoped shadcn-style tokens, layout, focus, and state presentation without changing the native contract.
  • gallery only Theme switching, source copying, search, fixtures, and inspection controls on this page belong to the gallery only; :separator does not ship them.
  • application boundary ShadcnUI does not add application state, authorization, persistence, transport events, or a JavaScript behavior layer to this component.

Examples use package semantic tokens in explicit light and dark scopes.

Accessibility and browser support

Native elements, names, relationships, focus, and keyboard behavior remain authoritative.

Separator support and fallback
Feature Locked-engine evidence When missing
Native baseline Reviewed in the locked Chromium, Firefox, and WebKit evidence matrix. No script is required. Without package CSS or an optional feature, content and native controls remain available in source order.
Exact fallback The locked-engine matrix retains the documented native or static outcome. No script is required. Without package CSS or an optional feature, content and native controls remain available in source order.

Application ownership and API

The caller decides whether a boundary is meaningful. Content order remains intact without CSS.

Public API Package source

Provenance

Catalogue identity content.separator, adapted from unscripted/ui commit bd8f403030c8d1f46804da6eda733fde7e908e63 under its MIT notice.

The documentation presentation is adapted locally; ShadcnUI's Phoenix API and native semantic contract remain authoritative.

Add a native HEEX hr contract and an explicitly aria-hidden decorative mode while adapting the pinned semantic border token into isolated horizontal and vertical presentation.