Skip to main content
Corporate IdentityUniversity of Johannesburg
Settings
Appearance
Design
Menu

Navigation

Breadcrumbs

Show the current page within its canonical UJ hierarchy.

stable@uj/design/navigationVersion 1.16.1Package 1.16.1

Production component

Live preview

This example is rendered from the same package consumed by UJ applications.

Composition

Breadcrumbs or breadcrumb bar

Choose the wrapper from the page context; do not recreate either presentation in application CSS.

Public pages: place UjBreadcrumbBar between the site header and page content. It owns the full-width surface, border and aligned uj-container.

Governed containers: use UjBreadcrumbs directly when a page header, hero or administration shell already owns the surface and content alignment.

Both forms use the same semantic ordered list, link treatment, current-page state, responsive reflow and design tokens. Pass the real route hierarchy in order; do not infer browsing history or hide intermediate items. Use accessibleLabel to expand an unfamiliar abbreviation such as CBE, and use lang or dir only when the item differs from its page context.

<UjBreadcrumbBar
  items={[
    { href: "/", label: "Home" },
    { href: "/faculties", label: "Faculties" },
    {
      accessibleLabel: "CBE — College of Business and Economics",
      label: "CBE",
      lang: "en-ZA",
    },
  ]}
/>

Contract

Usage and quality requirements

The contract keeps purpose, states and ownership visible before a component is reused.

usage

  • Use verified UJ content
  • Reuse semantic tokens
  • Keep business logic in the owning application

states

  • default
  • focus-visible
  • disabled or unavailable where applicable
  • long content
  • narrow viewport
  • dark theme

purpose

Show location and canonical hierarchy.

responsive

  • 320px
  • 768px
  • 1440px
  • 200% text resize

accessibility

  • Native semantics first
  • WCAG 2.2 AA
  • Keyboard and touch operation
  • No colour-only meaning
Breadcrumbs | UJ Corporate Identity