Breadcrumb

Navigation
stable

Hierarchical navigation trail rendered as a <nav> landmark with an ordered list of items and configurable dividers.

Aperçu

Rendu de l’aperçu en cours…

default

Rendu de l’aperçu en cours…

icon divider

Rendu de l’aperçu en cours…

with color

Structure

Anatomie

Décomposition visuelle de la structure interne du composant avec les appels de classes BEM.

Anatomy of OrigamBreadcrumbSchematic of the Breadcrumb component with 4 numbered internal parts. Home / Components / Breadcrumb 1 2 3 4
Anatomy of <origam-breadcrumb> — root <nav> ①, ordered list ②, divider ③ and individual items ④. The last item is visually dimmed and aria-current="page".
1.origam-breadcrumb
Root
2.origam-breadcrumb__items
    flex row containing all item+divider pairs. list-style: none; margin-block: 0.
3.origam-breadcrumb__item
  • wrapper for one item + its trailing divider. display: flex; align-items: center.
  • 4.origam-breadcrumb__divider
    OrigamBreadcrumbDivider separator. aria-hidden. Not rendered after the last item.

    API

    Props

    Toutes les props acceptées par ce composant, avec leur type, valeur par défaut et description.

    disabled
    boolean
    false
    Disables all breadcrumb items. Propagated via OrigamDefaultsProvider.
    divider
    '/'
    Divider character or MDI icon displayed between items. Propagated to OrigamBreadcrumbDivider via slotDefaults.
    Breadcrumb trail items. Accepts strings (converted to { title }) or full IBreadcrumbItemProps objects. The last item is automatically disabled and active.
    color
    Intent or custom foreground color propagated to all items.
    bgColor
    Background color of the breadcrumb container.
    tag
    string
    'nav'
    HTML element rendered at the root. Defaults to <nav> for correct landmark semantics.
    id
    string
    class
    string | Array<string> | object
    style
    string | Array<string> | object | StyleValue
    density
    'default'
    Density modifier affecting padding and item sizing.
    Border-radius token or boolean for the container.
    roundedTopRight
    boolean | number | string
    roundedTopLeft
    boolean | number | string
    roundedBottomLeft
    boolean | number | string
    roundedBottomRight
    boolean | number | string
    roundedStartStart
    boolean | number | string
    roundedStartEnd
    boolean | number | string
    roundedEndStart
    boolean | number | string
    roundedEndEnd
    boolean | number | string
    padding
    boolean | number | string
    Custom padding override.
    paddingTop
    boolean | number | string
    paddingLeft
    boolean | number | string
    paddingBottom
    boolean | number | string
    paddingRight
    boolean | number | string
    paddingBlock
    boolean | number | string
    paddingInline
    boolean | number | string
    paddingInlineStart
    boolean | number | string
    paddingInlineEnd
    boolean | number | string
    paddingBlockStart
    boolean | number | string
    paddingBlockEnd
    boolean | number | string
    margin
    boolean | number | string
    Custom margin override.
    marginTop
    boolean | number | string
    marginLeft
    boolean | number | string
    marginBottom
    boolean | number | string
    marginRight
    boolean | number | string
    marginBlock
    boolean | number | string
    marginInline
    boolean | number | string
    marginInlineStart
    boolean | number | string
    marginInlineEnd
    boolean | number | string
    marginBlockStart
    boolean | number | string
    marginBlockEnd
    boolean | number | string
    border
    boolean | number | string | TDirectionBoth | Array<TDirectionBoth>
    false
    Applies a border to the breadcrumb container.
    borderTop
    boolean | number | string
    borderLeft
    boolean | number | string
    borderBottom
    boolean | number | string
    borderRight
    boolean | number | string
    borderBlock
    boolean | number | string
    borderInline
    boolean | number | string
    borderInlineStart
    boolean | number | string
    borderInlineEnd
    boolean | number | string
    borderBlockStart
    boolean | number | string
    borderBlockEnd
    boolean | number | string
    borderColor
    string
    borderStyle
    string
    borderTopColor
    TColor
    borderRightColor
    TColor
    borderBottomColor
    TColor
    borderLeftColor
    TColor
    borderInlineStartColor
    TColor
    borderInlineEndColor
    TColor
    borderBlockStartColor
    TColor
    borderBlockEndColor
    TColor
    elevation
    TElevation
    Box-shadow elevation token.
    hover
    boolean | IStateEffectConfig
    hoverClass
    string
    active
    boolean | IStateEffectConfig
    activeClass
    string
    CSS class applied to the active (last) breadcrumb item.

    API

    Slots

    Emplacements de contenu exposés par ce composant.

    #default
    Full override of the breadcrumb content. When present, items prop and the default <ol> are not rendered.
    #item
    Override every breadcrumb item. Receives the normalized item object and its index.
    #item.title
    Override the title content inside each OrigamBreadcrumbItem.
    #item.{index}
    Override a specific item by index.
    #divider
    Override every divider. Receives the current divider string/icon.
    #divider.{index}
    Override a specific divider by index.

    API

    Membres exposés

    Propriétés et méthodes accessibles via ref template (defineExpose). Utilisés pour le contrôle programmatique.

    <T extends object>(props: T, exclude?: string[]) => Partial<T>
    Utility to forward a filtered subset of props to child components.
    Ref<string>
    Reactive CSS string generated by useStyle.
    string
    Unique style-sheet ID for this instance.
    () => void
    Injects the computed style sheet.
    () => void
    Removes the injected style sheet.
    Ref<boolean>
    True once the style sheet has been injected.

    Personnalisation

    Variables CSS

    Propriétés CSS personnalisées exposées par ce composant. Surchargez-les pour personnaliser sans perdre la compatibilité avec le thème.

    Default text color of the breadcrumb container.
    Container background (transparent by default).
    Block-start padding (density-adjusted at render time).
    Inline-start padding.
    Container border-radius. Overridden by rounded prop.
    Container box-shadow. Overridden by elevation.
    Default item text color.
    Item color on hover (link affordance).
    Color of the current-page item (last crumb).
    Divider glyph or icon color.
    Horizontal padding around the divider (breathing room between crumbs).

    Inclusion

    Accessibilité

    Rôles ARIA, navigation clavier et gestion du focus. Sourcé depuis le template réel du composant.

    Rôles ARIA

    navigation
    list
    listitem

    Interactions clavier

    Interactions clavier
    ToucheAction
    TabMoves focus through each breadcrumb item link.
    EnterFollows the link of the focused breadcrumb item.

    Notes

    • The root <nav> receives aria-label="Breadcrumb" from the useLocale translation (key: origam.breadcrumb.ariaLabel).
    • The last item is automatically set to aria-current="page" via the isActive prop on OrigamBreadcrumbItem.
    • OrigamBreadcrumbDivider is aria-hidden — the separators are purely presentational and not read by screen readers.
    • The v-contrast directive is applied to the root for auto contrast when a custom color is set.
    • Disabled items receive opacity-50 and pointer-events: none without the native disabled attribute (which does not apply to anchors).

    Fondation

    Design tokens

    Extrait des tokens de ce composant — les variables --origam-<composant>---<propriété>, déclarées dans sa feuille de tokens tenue à la main, sans étape de build.

    Source
    color
    var(--origam-color__text---primary)
    Container text color.
    color
    rgba(0, 0, 0, 0)
    Container background.
    color
    var(--origam-color__action--primary---bg)
    Item color on hover.
    color
    var(--origam-color__text---secondary)
    Current-page item color.
    color
    var(--origam-color__text---secondary)
    Divider color.
    dimension
    var(--origam-space---2)
    Divider horizontal padding.

    Interactif

    Playground

    Modifiez les props en direct et observez le composant se mettre à jour. Le snippet de code généré suit vos changements.

    Rendu de l’aperçu en cours…

    Usage

    Exemples

    Extraits de code prêts à coller dans vos templates.

    Basic breadcrumb

    vue

    With router links

    vue

    Custom divider slot

    vue

    Écosystème

    Famille

    Composants du même dossier qui partagent les conventions et se composent souvent ensemble.