mcordingley / breadcrumbs
Laravel DRY 面包屑助手包
Requires
- php: ^7.2.0
- ext-json: *
- illuminate/config: ^5.7
- illuminate/support: ^5.7
- illuminate/view: ^5.7
Requires (Dev)
- ext-xml: *
- mockery/mockery: ^1.2
- orchestra/testbench: ^3.8
- phpunit/phpunit: ^8.1
This package is auto-updated.
Last update: 2024-09-11 15:40:50 UTC
README
安装和配置
Breadcrumbs 是一个简单的 Laravel 插件,用于简化面包屑路由和名称。首先通过 Composer 安装它。
composer require mcordingley/breadcrumbs
该包会自动注册其服务提供者和外观,所以剩下的步骤就是发布配置和示例面包屑定义文件。
php artisan vendor:publish
这将创建 config/breadcrumbs.php 和 resources/breadcrumbs.json。如果你使用的是默认设置,无需修改配置文件或在你的 .env 文件中创建新条目。
JSON 文件包含你的单个面包屑条目,其中路由作为键。每个条目必须有一个 title 属性,如果页面属于另一个页面,则它还应该有一个 parent 属性,包含父页面的路由。库使用此属性递归查找当前页面的上一级面包屑。
如果 JSON 文件中的条目包含模式 {foo},则文本将被传递给面包屑时传入的属性 foo 替换。此模式还支持点表示法来提取嵌套属性。
默认情况下,面包屑格式化为与 Bootstrap 一起使用。如果你需要不同的格式,请在你的 .env 文件中设置 BREADCRUMBS_VIEW,并使用你希望使用的视图名称。
用法
在你的视图中,只需在 Breadcrumb 外观上调用 make,传入你的面包屑路径和可选的格式化路径和标题所需的任何参数。由于输出是字符串且将包含 HTML,因此你将想要使用未转义的 标签来输出你的面包屑。所有注入到输出中的值都应该由模板视图转义。
{!! Breadcrumb::make('/foo/{foo.id}/edit', ['foo' => ['id' => 4, 'name' => 'Four']) !!}