首页
/ Fantastic-admin 路由配置技巧:实现多级嵌套路由与隐藏子路由

Fantastic-admin 路由配置技巧:实现多级嵌套路由与隐藏子路由

2025-06-28 11:00:28作者:邬祺芯Juliet

Fantastic-admin 是一个基于 Vue.js 的后台管理系统框架,提供了强大的路由管理功能。在实际开发中,我们经常需要实现多级嵌套路由结构,同时隐藏某些子路由不在菜单中显示。本文将详细介绍如何配置这种路由结构。

路由结构需求分析

常见的后台管理系统路由需求如下:

  1. 三级路由嵌套结构
  2. 隐藏第三级路由不在侧边栏显示
  3. 保持面包屑导航的正确层级
  4. 不影响路由缓存功能

典型的URL结构示例:

/一级路由
    /一级路由/二级路由
        /一级路由/二级路由/三级路由
    /一级路由/二级路由
        /一级路由/二级路由/三级路由

路由配置实现

在 Fantastic-admin 中,可以通过以下方式实现这种路由结构:

children: [
  {
    path: '/parent',
    component: Layout,
    redirect: '/parent/child1',
    name: 'parent',
    meta: {
      title: '父级菜单',
      icon: 'ant-design:home',
    },
    children: [
      {
        path: 'child1',
        name: 'child1',
        component: () => import('@/views/parent/child1.vue'),
        meta: {
          title: '子菜单1',
          cache: 'grandchild1', // 指定缓存名称
        },
        children: [
          {
            path: 'detail',
            name: 'grandchild1',
            component: () => import('@/views/parent/child1-detail.vue'),
            meta: {
              title: '详情页',
              sidebar: false, // 隐藏该路由不在侧边栏显示
            },
          }
        ]
      },
      {
        path: 'child2',
        name: 'child2',
        component: () => import('@/views/parent/child2.vue'),
        meta: {
          title: '子菜单2',
          cache: 'grandchild2',
        },
        children: [
          {
            path: 'detail',
            name: 'grandchild2',
            component: () => import('@/views/parent/child2-detail.vue'),
            meta: {
              title: '详情页',
              sidebar: false,
            },
          }
        ]
      }
    ]
  }
]

关键配置说明

  1. 多级路由嵌套:通过 children 属性实现路由的层级嵌套,可以无限级扩展。

  2. 隐藏子路由:在 meta 中设置 sidebar: false 可以隐藏该路由不在侧边栏菜单显示。

  3. 路由缓存:通过 meta 中的 cache 属性指定缓存名称,确保详情页能够正确缓存。

  4. 面包屑导航:Fantastic-admin 会自动根据路由层级生成面包屑导航,无需额外配置。

最佳实践建议

  1. 对于详情类页面,建议使用 sidebar: false 隐藏,避免菜单过于臃肿。

  2. 合理规划路由 name 和 cache 名称,便于维护和理解。

  3. 对于复杂路由结构,建议添加注释说明路由关系。

  4. 保持路由层级不超过3-4级,避免用户体验下降。

通过以上配置方式,可以在 Fantastic-admin 中实现清晰的路由结构,同时保持菜单简洁和功能完整。这种配置方式既满足了业务需求,又遵循了最佳实践原则。

登录后查看全文
热门项目推荐
相关项目推荐