Presentation

Breadcrumb

Navigation trail component for hierarchical pages, with configurable roots and HTML renderer.

Purpose

Breadcrumb encapsulates route-path navigation rendering. It keeps controller code focused on page data while trail creation and HTML output stay in dedicated classes.

Core API

BreadcrumbComponent is a facade over factory + renderer. Use frontend(), admin() or empty() to create a trail and render() to output HTML.

$trail = $component->breadcrumb()->frontend('Catalog', '/catalog');
$trail->add('Laptops', '/catalog/laptops');
$trail->add('ThinkPad X1', null, true);

echo $component->breadcrumb()->render($trail);

Configuration

Default roots and CSS class tokens are configured under breadcrumbs.frontend.*, breadcrumbs.admin.* and breadcrumbs.classes.

'breadcrumbs' => [
    'frontend' => ['root_label' => 'Home', 'root_url' => '/'],
    'admin' => ['root_label' => 'Admin', 'root_url' => '/admin'],
    'classes' => [
        'ul' => 'breadcrumb',
        'li' => 'breadcrumb-item{active}',
    ],
],