mcordingley/breadcrumbs

Laravel DRY 面包屑助手包

v1.0.0 2019-05-08 18:29 UTC

This package is auto-updated.

Last update: 2024-09-11 15:40:50 UTC


README

Build Status Code Climate Code Climate

安装和配置

Breadcrumbs 是一个简单的 Laravel 插件,用于简化面包屑路由和名称。首先通过 Composer 安装它。

composer require mcordingley/breadcrumbs

该包会自动注册其服务提供者和外观,所以剩下的步骤就是发布配置和示例面包屑定义文件。

php artisan vendor:publish

这将创建 config/breadcrumbs.phpresources/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']) !!}