inteve/navigation

Navigation component for Nette Framework.

Inteve\Navigation

, _(*1)

Navigation component for Nette Framework., _(*2)

, _(*3)

Installation

Download a latest package or use Composer:, _(*4)

composer require inteve/navigation

Inteve\Navigation requires PHP 8.0 or later and Nette 2.2+ or 3.0+., _(*5)

Usage

Define pages

``` php <?php, <sub>(*6)</sub>

use Inteve\Navigation\Navigation;, <sub>(*7)</sub>

$navigation = new Navigation; $navigation->addPage('/', 'Homepage'); $navigation->addPage('contact', 'Contact'); $navigation->addPage('news', 'News'); $navigation->addPage('news/2016', 'News 2016'); $navigation->addPage('news/2015', 'News 2015');, <sub>(*8)</sub>

$navigation->setDefaultPage('/'); $navigation->setCurrentPage('news/2016'); $navigation->isPageCurrent('news/2016'); // returns bool $navigation->isPageActive('news'); // returns bool, <sub>(*9)</sub>

### Breadcrumbs

``` php
<?php

$navigation->addItem('Detail');
$navigation->addItemBefore('/', 'My Website', ':Homepage:default');
$navigation->addItemAfter('news/2016', 'Page 1', ':News:default', array('page' => 1));
$breadcrumbs = $navigation->getBreadcrumbs();

Render menu

``` php <?php, <sub>(*10)</sub>

use Inteve\Navigation\Navigation; use Inteve\Navigation\MenuControl;, <sub>(*11)</sub>

class NewsPresenter extends Nette\Application\UI\Presenter { /** @var Navigation @inject */ public $navigation;, <sub>(*12)</sub>

protected function createComponentNewsMenu()
{
    // render items 'News 2016' & 'News 2015'
    $menu = new MenuControl($this->navigation);
    $menu->setSubTree('news');
    return $menu;
}


protected function createComponentSubMenu()
{
    // Renders submenu by current page
    // for setCurrentPage('news') or setCurrentPage('news/any/thing') it renders items 'news/2016' & 'news/2015'
    // for setCurrentPage('contact') it renders nothing
    $menu = new MenuControl($this->navigation);
    $menu->setSubTree('/');
    $menu->setSubLevel(1);
    return $menu;
}

}, <sub>(*13)</sub>

In Latte template:

```latte
{control newsMenu}

Render breadcrumbs

``` php <?php, <sub>(*14)</sub>

use Inteve\Navigation\Navigation; use Inteve\Navigation\BreadcrumbsControl;, <sub>(*15)</sub>

class Presenter extends Nette\Application\UI\Presenter { /** @var Navigation @inject */ public $navigation;, <sub>(*16)</sub>

protected function createComponentBreadcrumbs()
{
    return new BreadcrumbsControl($this->navigation);
}

}, <sub>(*17)</sub>

In Latte template:

```latte
{control breadcrumbs}

License: New BSD License
Author: Jan Pecha, https://www.janpecha.cz/, <sub>(*18)</sub>