Skip to content

Breadcrumbs

The bq-breadcrumbs component renders a navigation trail with auto-inserted separators and marks the last item as the current page.

Basic Usage

html
<bq-breadcrumbs>
  <a href="/">Home</a>
  <a href="/products">Products</a>
  <a href="/products/widgets">Widgets</a>
</bq-breadcrumbs>

Custom Separator

html
<bq-breadcrumbs separator="›">
  <a href="/">Home</a>
  <a href="/docs">Docs</a>
  <a href="/docs/api">API</a>
</bq-breadcrumbs>

Properties

PropertyTypeDefaultDescription
separatorstring'/'Separator character or text

Slots

SlotDescription
(default)Navigation links (<a> elements)

CSS Parts

PartDescription
navThe <nav> wrapper
listThe breadcrumb list container

CSS Custom Properties

PropertyDefaultDescription
--bq-breadcrumb-separator"/"CSS content value used between items. Override directly when not setting the separator attribute.
css
bq-breadcrumbs {
  --bq-breadcrumb-separator: "›";
}

Accessibility

The last breadcrumb item is automatically marked with aria-current="page". The component renders inside a <nav> with an appropriate aria-label. Separators are produced via a CSS ::before pseudo-element so they are visible but not part of the DOM — keeping them out of copy/paste output and assistive-technology readings.

Released under the MIT License.