深入理解Twill项目中的导航系统配置

最新推荐文章于 2025-06-10 09:18:43 发布

童兴富Stuart

最新推荐文章于 2025-06-10 09:18:43 发布

阅读量285

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01151/article/details/148552134

深入理解Twill项目中的导航系统配置

twill Twill is an open source CMS toolkit for Laravel that helps developers rapidly create a custom admin console that is intuitive, powerful and flexible. Chat with us on Discord at https://discord.gg/cnWk7EFv8R. 项目地址: https://gitcode.com/gh_mirrors/tw/twill

Twill作为一个功能强大的CMS框架，提供了灵活且强大的导航系统配置方式。本文将详细介绍Twill 3.x版本后的两种导航配置方法，帮助开发者更好地构建和管理后台导航结构。

导航层级概述

Twill的导航系统分为三个清晰的层级：

主导航(Primary)：最高级别的导航项，通常对应主要功能模块
次级导航(Secondary)：仅在所属的主导航项激活时显示
三级导航(Tertiary)：仅在所属的次级导航项激活时显示

这种层级结构使得复杂的管理后台也能保持清晰的组织架构。

面向对象编程方法（推荐）

Twill 3.x推荐在AppServiceProvider中使用面向对象的方式定义导航结构。这种方法更加直观且易于维护。

基本配置示例

use A17\Twill\Facades\TwillNavigation;
use A17\Twill\View\Components\Navigation\NavigationLink;

public function boot(): void
{
    // 添加一个简单的页面模块导航
    TwillNavigation::addLink(
        NavigationLink::make()->forModule('pages')
    );
    
    // 添加一个包含多级导航的工作模块
    TwillNavigation::addLink(
        NavigationLink::make()->forModule('projects')
          ->setChildren([
            NavigationLink::make()->forModule('projects')
              ->setChildren([
                NavigationLink::make()->forModule('projectCustomers'),
              ]),
            NavigationLink::make()->forModule('clients'),
            NavigationLink::make()->forModule('industries'),
            NavigationLink::make()->forModule('studios'),
          ]),
    );
}

路由配置示例

use A17\Twill\Facades\TwillRoutes;

// 注册页面模块路由
TwillRoutes::module('pages');

// 工作模块下的嵌套路由
Route::group(['prefix' => 'work'], function () {
    Route::group(['prefix' => 'projects'], function () {
        TwillRoutes::module('projectCustomers');
    });
    TwillRoutes::module('projects');
    TwillRoutes::module('clients');
    TwillRoutes::module('industries');
    TwillRoutes::module('studios');
});

这种方法通过链式调用和清晰的层级关系，使得导航结构一目了然。

传统配置方法（兼容旧版本）

对于需要维护旧版本项目的开发者，Twill仍然支持通过配置文件定义导航结构。

配置文件结构

导航配置位于config/twill-navigation.php文件中，采用嵌套数组的形式定义：

return [
    'pages' => [
        'title' => 'Pages',
        'module' => true,  // 表示这是一个模块导航
    ],
    'work' => [
        'title' => 'Work',
        'route' => 'admin.work.projects.index',
        'primary_navigation' => [
            'projects' => [
                'title' => 'Projects',
                'module' => true,
                'secondary_navigation' => [
                    'projectCustomers' => [
                        'title' => 'Customers',
                        'module' => true
                    ],
                ]
            ],
            // 其他主导航项...
        ],
    ],
];