Spatie Menu 使用教程

Spatie Menu 使用教程

menu Html menu generator 项目地址: https://gitcode.com/gh_mirrors/menu/menu

1. 项目介绍

Spatie Menu 是一个 PHP 库，提供了一个流畅的接口来构建任何大小的菜单在你的 PHP 应用程序中。它特别适用于 Laravel 应用程序，并且提供了一个 Laravel 版本的扩展包 spatie/laravel-menu，为 Laravel 开发者提供了额外的功能。Spatie Menu 支持无限嵌套的子菜单，并且可以轻松地为菜单项添加 HTML 类和属性。

2. 项目快速启动

首先，你需要通过 Composer 安装 Spatie Menu 包：

composer require spatie/menu

以下是一个创建基本菜单的示例代码：

use Spatie\Menu\Menu;

$men = Menu::new()
    ->add(Link::to('/', 'Home'))
    ->add(Link::to('/about', 'About'))
    ->add(Link::to('/contact', 'Contact'));

echo $men->render();

这段代码会生成一个包含“Home”、“About”和“Contact”链接的简单菜单。

3. 应用案例和最佳实践

添加 HTML 类和属性

你可以给菜单项添加 HTML 类和属性来定制样式：

$men = Menu::new()
    ->add(Link::to('/')
        ->addClass('home-link')
        ->attr('title', '主页'))
    ->add(Link::to('/about')
        ->addClass('about-link'))
    ->add(Link::to('/contact')
        ->addClass('contact-link'));

创建子菜单

Spatie Menu 支持创建子菜单，以下是一个例子：

$submenu = Menu::new()
    ->add(Link::to('/subpage1', 'Subpage 1'))
    ->add(Link::to('/subpage2', 'Subpage 2'));

$men = Menu::new()
    ->add(Link::to('/', 'Home'))
    ->add(Link::to('/about', 'About'))
    ->add(Link::to('/contact', 'Contact'))
    ->add('More', $submenu);

为 Laravel 定制

如果你的项目是 Laravel 应用，你可以使用 spatie/laravel-menu 来更方便地创建菜单：

use Spatie\Menu\Laravel\Menu;

Menu::macro('main', function () {
    return Menu::new()
        ->action('HomeController@index', 'Home')
        ->action('AboutController@index', 'About')
        ->action('ContactController@index', 'Contact')
        ->setActiveFromRequest();
});

echo Menu::main();

4. 典型生态项目

Spatie Menu 作为一个流行的菜单生成库，它的生态中涌现了一些相关的项目，比如：

• spatie/laravel-menu: 为 Laravel 提供了集成的菜单功能。
• spatie/menu-builder: 一个为 Spatie Menu 提供可视化界面来构建菜单的包。

这些项目可以进一步扩展 Spatie Menu 的功能和易用性。

menu Html menu generator 项目地址: https://gitcode.com/gh_mirrors/menu/menu