Read page as text

NIB / DOCUMENTATION

Breadcrumb — NibComponents

Navigate a local path and reveal collapsed ancestors without treating the current location as a link.

Open interactive view

Make the final crumb the current location

The preview starts at Workspace / Projects / Atlas / Design notes. Activate an earlier crumb to shorten the local path; Restore full path restores the starting trail. This demonstrates onTap without navigating away from the documentation.

NibBreadcrumbItem contains a label, optional icon, and callback. The last item is always current and non-interactive, even when it has an onTap. An earlier item without a callback is also plain text. Application routing remains your callback’s responsibility.

Keep ancestors reachable when space runs out

maxVisibleItems limits the visible trail. itemsBeforeCollapse and itemsAfterCollapse select how many ancestors remain around the overflow control. Activate the overflow to reach hidden ancestors through the package’s popover.

breadcrumbVisibleIndices is the public pure helper for the same index model: integers represent visible items and null represents the overflow slot. It does not render or perform routing. The example’s first and last labels remain meaningful when middle items are collapsed.

Style links without losing location

linkColor, currentColor, separatorColor, fontSize, itemPadding, and gap are instance overrides. separator can replace the default divider widget. semanticLabel names the path as a whole. disabled prevents the breadcrumb links from activating.

The current local path is separate from appearance controls. Changing the maximum visible count or theme does not reset the selected location. Test translated labels and large text; shortening a label is a content decision, not a substitute for a functional overflow menu.

Check the overflow in its real host

overflowPlacement selects the preferred NibPopoverPlacement. The overflow uses the real popover machinery, so theme inheritance, overlay containment, and edge placement must be checked in the host where the breadcrumb appears.

The public helper computes which indices appear; it cannot prove that a popup fits every embedded viewport. Test narrow layouts and keyboard access to hidden items. Keep a direct route or another navigation path available when a user does not use breadcrumbs.