WireUi Breadcrumbs
🔥
Breadcrumbs
This package provides a beautiful breadcrumbs component, with a simple and easy way to define your breadcrumbs.
You can define it in routes or full page livewire components.
📚
Get Started
Prerequisites:
Optional
If you want to use the default breadcrumbs component, you need to install these packages.
Install
composer require wireui/breadcrumbs
Using Tailwind?
Add the breadcrumbs path to the content of your Tailwind config file.
/** @type {import('tailwindcss').Config} */
module.exports = {
...
content: [
'./vendor/wireui/breadcrumbs/src/**/*.php',
],
...
}
How to use it?
You can define it on routes by calling the breadcrumbs method in the route or the livewire component.
This method accepts a callable function that returns the Trail instance.
Dependency Injection
The callable function can resolve all dependency injections, like classes, services, models, etc.
use Illuminate\Support\Facades\Route;
use WireUi\Breadcrumbs\Trail;
Route::get('/users/{user}', Index::class)
->breadcrumbs(function (
Trail $trail,
User $user,
Request $request,
Foo $foo
) {
return $trail
->push('Users', route('users'))
->push('View');
})
->name('users.view');
Routes
You can define your breadcrumbs in the routes
use Illuminate\Support\Facades\Route;
use WireUi\Breadcrumbs\Trail;
Route::get('/users/create', Index::class)
->breadcrumbs(function (Trail $trail) {
return $trail
->push('Users', route('users'))
->push('Create');
})
->name('users.create');
Livewire Components
You can define your breadcrumbs in the livewire components.
The breadcrumbs in the livewire components is reactive
<?php
namespace App\Http\Livewire;
use Livewire\Component;
use WireUi\Breadcrumbs\Trail;
class Index extends Component
{
...
public function breadcrumbs(Trail $trail): Trail
{
return $trail
->push('Users', route('users'))
->push('Create 1');
}
...
}
Rendering
Just add the breadcrumbs component in your layout
<x-breadcrumbs />
Publish (Optional)
php artisan vendor:publish --tag="wireui.breadcrumbs.config"
php artisan vendor:publish --tag="wireui.breadcrumbs.views"
📣
Follow the author
Stay informed about WireUI, follow @ph7jack on Twitter.
You will you see all the latest news about features, ideas, discussions, and more...
💡
Philosophy
WireUI Breadcrumbs is always FREE to anyone who would like to use it. You can use the Breadcrumbs in your laravel project.
This project is created PH7-Jack, and it is maintained by the author with the help of the community.
All contributions are welcome!
22 Oct 6, 2022
792 Jan 3, 2023
19 Dec 14, 2022
680 Jan 4, 2023
1.3k Jan 1, 2023
233 Jan 4, 2023
87 Oct 13, 2022
20 Aug 11, 2022
7 Nov 15, 2022
1.8k Jan 7, 2023
28 Oct 12, 2022
54 Feb 15, 2022
20 Nov 29, 2022
64 Dec 28, 2022
3.9k Dec 29, 2022
150 Nov 29, 2022
70 Feb 5, 2022
201 Dec 11, 2022
31 Dec 7, 2022
15 Jan 18, 2022