evomase/laracrumbs

为 Laravel 路由添加面包屑的轻量级方式

dev-master 2017-07-24 14:54 UTC

This package is auto-updated.

Last update: 2024-09-04 20:00:58 UTC


README

Laracrumbs 是一个轻量级的 Laravel 扩展包,提供了向 面包屑 添加 路由 功能

要求

  • PHP 7.0
  • Laravel 5.4+

安装

要开始使用,请通过 Composer 安装 Laracrumbs

composer require evomase/laracrumbs

接下来,将 Laracrumbs 服务提供者注册到 config/app 配置文件的 providers 数组中

Laracrumbs\Providers\ServiceProvider::class

基本用法

注册

通过使用已注册的路由并定义一个 回调 来返回每个段标题来创建面包屑。以下示例展示了如何实现

//Create Route
$route = Route::get('/', 'Controller@method');

//Add route to Breadcrumb
Breadcrumbs::add($route, function(){
    return 'Home';
});

分配给路由的所有参数也将传递给 回调,这样您可以进一步自定义返回值。另外,服务容器中的对象将自动注入到回调中,如下例所示。

$route = Route::get('users/{user}/edit', 'Controller@method');
Breadcrumbs::add($route, function(App\User $user, Illuminate\Container $app){
   // return a string
});

渲染

已添加一个面包屑视图,可以包含在任何视图模板中。一旦包含,它将自动生成与当前请求关联的面包屑。

<div class="container">
    @include('laracrumbs::breadcrumbs')
</div>

面包屑视图模板的副本可以在 resources\views\vendor 中找到

许可证

Laracrumbs 是开源软件,使用 MIT 许可证授权