Skip to content

Support long breadcrumb trails - #3121

Merged
tabuna merged 1 commit into
masterfrom
codex/breadcrumb-long-trails
Aug 14, 2026
Merged

Support long breadcrumb trails#3121
tabuna merged 1 commit into
masterfrom
codex/breadcrumb-long-trails

Conversation

@tabuna

@tabuna tabuna commented Aug 14, 2026

Copy link
Copy Markdown
Member

Summary

  • replace the direct x-tabuna-breadcrumbs rendering with a dedicated Orchid breadcrumb component
  • keep short breadcrumb trails unchanged while collapsing the middle of trails longer than three items into a dropdown
  • preserve the first item and the final two items so users retain both hierarchy context and the current destination
  • render linked and non-linked crumbs appropriately, mark the current item, and provide breadcrumb navigation semantics

Why

Long breadcrumb trails currently render every item inline. On narrower layouts this consumes significant horizontal space and makes the page hierarchy difficult to scan. Collapsing only the middle section keeps the most useful context visible without losing access to intermediate destinations.

Implementation

The new orchid-breadcrumbs Blade component reads the current trail from the breadcrumb manager and prepares one of two representations:

  • up to three crumbs: render the complete trail
  • more than three crumbs: render the first crumb, a dropdown containing the middle crumbs, and the final two crumbs

The component does not render when no breadcrumbs are registered. The dashboard now delegates breadcrumb presentation to this component, and the component is registered through FoundationServiceProvider.

localhost_8000_admin_examples_breadcrumbs_navigation_patterns_hierarchy_current localhost_8000_admin_examples_breadcrumbs_navigation_patterns_hierarchy_current (1)

Verification

  • php -l src/Platform/Components/Breadcrumbs.php
  • php -l src/Platform/Providers/FoundationServiceProvider.php
  • pint --test src/Platform/Components/Breadcrumbs.php src/Platform/Providers/FoundationServiceProvider.php
  • verified that the branch contains exactly one commit on top of master

@tabuna
tabuna merged commit b9abe21 into master Aug 14, 2026
58 of 62 checks passed
@tabuna
tabuna deleted the codex/breadcrumb-long-trails branch August 14, 2026 15:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant