61 lines
2.0 KiB
ReStructuredText
61 lines
2.0 KiB
ReStructuredText
################################################################################
|
|
Custom Templates
|
|
################################################################################
|
|
|
|
.. only:: html
|
|
|
|
.. contents::
|
|
:local:
|
|
|
|
|
|
================================================================================
|
|
Create a view
|
|
================================================================================
|
|
|
|
To customise the HTML, create your own view file (e.g. ``resources/views/_partials/breadcrumbs.blade.php``) like this:
|
|
|
|
.. code-block:: html+php
|
|
|
|
@if ($breadcrumbs)
|
|
<ul class="breadcrumb">
|
|
@foreach ($breadcrumbs as $breadcrumb)
|
|
@if (!$breadcrumb->last)
|
|
<li><a href="{{ $breadcrumb->url }}">{{ $breadcrumb->title }}</a></li>
|
|
@else
|
|
<li class="active">{{ $breadcrumb->title }}</li>
|
|
@endif
|
|
@endforeach
|
|
</ul>
|
|
@endif
|
|
|
|
(See the `views/ directory <https://github.com/davejamesmiller/laravel-breadcrumbs/tree/master/views>`_ for the built-in templates.)
|
|
|
|
|
|
.. _view-data:
|
|
|
|
----------------------------------------
|
|
View data
|
|
----------------------------------------
|
|
|
|
The view will receive an array called ``$breadcrumbs``.
|
|
|
|
Each breadcrumb is an object with the following keys:
|
|
|
|
- ``title`` - The breadcrumb title (see :doc:`defining`)
|
|
- ``url`` - The breadcrumb URL (see :doc:`defining`), or ``null`` if none was given
|
|
- ``first`` - ``true`` for the first breadcrumb (top level), ``false`` otherwise
|
|
- ``last`` - ``true`` for the last breadcrumb (current page), ``false`` otherwise
|
|
- Plus additional keys for each item in ``$data`` (see :ref:`custom-data`)
|
|
|
|
|
|
================================================================================
|
|
Update the config
|
|
================================================================================
|
|
|
|
Then update your config file (``config/breadcrumbs.php``) with the custom view name, e.g.:
|
|
|
|
.. code-block:: php
|
|
|
|
// resources/views/_partials/breadcrumbs.blade.php
|
|
'view' => '_partials/breadcrumbs',
|