Skip to content

Latest commit

 

History

History
120 lines (88 loc) · 4.05 KB

README-RU.md

File metadata and controls

120 lines (88 loc) · 4.05 KB
Raw

Laravel Menu Builder

Билдер меню для Laravel 4-5 под разметку Bootstrap.

Обратите внимание, что расширение поставляется без каких либо стилей и скриптов, их нужно отдельно установить с сайта Twitter Bootstrap, или сделать своё оформление на основе правил, которые задает это фреймфорк.

Установка

Установка с помощью Composer:

composer require kalnoy/illuminate-menu:~1.0

Добавте провайдер:

'providers' => [
    'Illuminate\Html\MenuServiceProvider',
],

И фасад для быстрого доступа:

'aliases' => [
    'Menu' => 'Illuminate\Support\Facades\Menu',
],

Документация

Вывод меню:

{!! Menu::render($items, $attributes) !!}

Где $attributes необязательный параметр с атрибутами для тэга ul.

Вывод только элементов меню без внешнего тэга:

<ul>{!! Menu::items($items) !!}</ul>

Вывод одного элемента меню:

{!! Menu::item($label, $url) !!}
{!! Menu::item($label, $options) !!}
{!! Menu::item($options) !!}

Список доступных опций доступен ниже.

Простой пример:

Menu::render([
    'Локальная ссылка' => 'bar',
    'Внешняя ссылка' => 'http://bar',
    [ 'label' => 'Локальная ссылка', 'url' => 'bar' ],
    'Ссылка на роут' => [ 'route' => [ 'route.name', 'foo' => 'bar' ] ],
]);

Вывод элемента меню с выпадающим списком:

{!! Menu::item([
    'label' => 'Настройки',
    'icon' => 'wrench',
    'items' => [
        'Foo' => 'bar',
        '-', // разделитель
        'Выйти' => [ 'route' => 'logout_path' ],
    ],
]) !!}

Управление видимостью элемента:

{!! Menu::item([
    'label' => 'Foo',
    'url' => 'bar',
    'visible' => function () { return Config::get('app.debug'); },
] !!}

Опции

Вы можете использовать следующий список опций:

  • label заголовок элемента меню; автоматически переводится, т.е. можно указать идентификатор строки
  • url ссылка на локальный или внешний адрес
  • route чтобы указать роут с параметрами или без
  • secure; укажите true чтобы сделать локальную ссылку безопасной (https) (влияет только на опцию url)
  • items список элементов в выпадающем меню
  • linkOptions массив дополнительных атрибутов ссылки

Изменение состояния элемента:

  • visible булевское значение или closure для указания видимости элемента
  • active булевское значение или closure; если значение true, то элементу добавляется класс active
  • disabled булевское значение или closure; если true, то элементу добавляется класс disabled и он становится некликабельным

Опции представления:

  • icon идентификатор иконки glyphicon, например pencil
  • badge значение для метки (скалярное или closure)
  • любой другой параметр, который будет считаться как атрибут для элемента <li>.