Pair framework: Breadcrumb

Pair\Html\Breadcrumb builds hierarchical navigation paths for pages and detail flows.

When to use

Use Breadcrumb in module views/layouts where users need clear navigation context and back-navigation behavior.

Main methods

• home(string $title, ?string $url = null): void
• segment(string $title, ?string $url): void
• getPath(): array
• getBackPath(): ?stdClass
• lastPathTitle(): string
• disableLastUrl(): void

Implementation examples

Standard path

$breadcrumb = new \Pair\Html\Breadcrumb();
$breadcrumb->home('Dashboard', '/dashboard');
$breadcrumb->segment('Orders', '/orders');
$breadcrumb->segment('Details', null);

$path = $breadcrumb->getPath();

Disable last segment link

$breadcrumb->home('Admin', '/admin');
$breadcrumb->segment('Users', '/admin/users');
$breadcrumb->segment('Edit', '/admin/users/edit/42');
$breadcrumb->disableLastUrl();

Common pitfalls

• Treating the last editable screen as a clickable breadcrumb can confuse users.
• Missing home segment reduces orientation on deep navigation trees.

See also: Menu, BootstrapMenu, MenuEntry.