循序漸進VUE+Element 前端應用開發(3）- 動態菜單和路由的關聯處理

循序漸進VUE+Element 前端應用開發(3）— 動態菜單和路由的關聯處理

2020 年 5 月 27 日
筆記
循序漸進VUE+Element

在我開發的很多系統裡面，包括Winform混合框架、Bootstrap開發框架等系列產品中，我都傾向於動態配置菜單，並管理對應角色的菜單許可權和頁面許可權，實現系統對用戶許可權的控制，菜單一般包括有名稱、圖標、順序、URL連接等相關資訊，對於VUE+Element 前端應用來說，應該原理上差不多，本篇隨筆介紹結合服務端的動態菜單配置和本地路由的關聯處理，實現動態菜單的維護和展示的處理。

1、菜單和路由的處理過程

由於Vue前端還需要引入路由這個概念，路由是我們前端可以訪問到的對應路徑集合，路由定義了常規菜單說沒有的很多複雜資訊，但是往往這些是我們不能隨意修改的，因此我們做法是以本地配置好的路由列表為基準，而菜單我們採用在後盾配置方式，前端通過介面動態獲取菜單列表，通過菜單的名稱和路由名稱的對應關係，我們以菜單集合為對照，然後過濾本地所有靜態路由的列表，然後獲得用戶可以訪問的路由列表，設置動態路由給前端，從而實現了介面根據用戶角色/許可權的不同，而變化用戶的菜單介面和可訪問路由集合。

菜單路由處理的大概的操作過程如下所示

前端介面的動態菜單、本地路由、菜單導航和可訪問路由的幾個概念如下所示。

在前端介面處理中，我們通過Element介面組件的方式展示動態菜單資訊，並結合菜單和路由的關係，實現菜單跳轉到對應視圖的處理過程。

2、菜單和路由列表

根據前面的介紹，我們定義了一些從服務端返回的動態菜單資訊，這些菜單資訊是一個JSON對象集合，如下介面所示。

[
  {
    id: '1',
    pid: '-1',
    text: '首頁',
    icon: 'dashboard',
    name: 'dashboard'
  },
  {
    id: '2',
    pid: '-1',
    text: '產品列表',
    icon: 'table',
    name: 'product'
  },
  {
    id: '3',
    pid: '-1',
    text: '一級菜單',
    icon: 'example',
    children: [
      {
        id: '3-1',
        pid: '3',
        text: '二級菜單1',
        name: 'icon',
        icon: 'example'
      },
      {
        id: '3-2',
        pid: '3',
        text: '二級菜單2',
        icon: 'tree',
        children: [
          {
            id: '3-2-1',
            pid: '3-2',
            text: '三級菜單1',
            name: 'form',
            icon: 'form'
          },
          {
            id: '3-2-2',
            pid: '3-2',
            text: '三級菜單2',
            name: 'menu1-1',
            icon: 'form'
          },
          {
            id: '3-2-3',
            pid: '3-2',
            text: '三級菜單3',
            name: 'menu1-2',
            icon: 'form'
          },
          {
            id: '3-2-4',
            pid: '3-2',
            text: '三級菜單4',
            name: 'menu1-3',
            icon: 'form'
          }
        ]
      }
    ]
  },
  {
    id: '99',
    pid: '-1',
    text: '公司官網',
    icon: 'table',
    name: 'external-link'
  }
]

菜單的JSON是根據角色進行動態獲取的，不同的角色對應不同的菜單集合，並且菜單是一個多層次的樹列表，可以定義無窮多級的展示，JSON格式化視圖如下所示。

而Vue前端需要初始化定義前端頁面的所有路由，這些包括路由頁面的Layout等資訊。

我們可以在一個JS文件裡面定義好對應前端所有的路由資訊，如下所示

// 定義本系統的所有路由，具體路由呈現經過菜單數據過濾
export const asyncRoutes = {
  'dashboard': {
    path: '/dashboard',
    component: Layout,
    children: [{
      path: 'dashboard',
      name: 'dashboard',
      component: () => import('@/views/dashboard/index')
    }]
  },
  'product': {
    path: '/product',
    component: Layout,
    children: [{
      path: '/product',
      name: 'product',
      component: () => import('@/views/Product/index')
    }]
  },

  .............................. //省略部分

  'icon': {
    path: '/icon',
    component: Layout,
    children: [{
      path: '/icon',
      name: 'icon',
      component: () => import('@/views/icons/index')
    }]
  },

  'external-link': {
    path: '//www.iqidi.com',
    name: 'external-link'
  }
}

這裡的路由不需要嵌套，因為菜單展示才需要定義嵌套關係。

另外，由於系統在未登錄請求後端動態菜單前，我們系統也需要正常運行起來，那麼就需要預設一些基礎的路由資訊，如登錄介面、重定向頁面、首頁鏈接等這些路由資訊，因此我們可以分開兩個路由對象，用來分開管理這些資訊。

對路由的管理，一個需要默認創建路由的處理、重置路由的處理，以及動態設置新的路由處理，我們封裝幾個函數來處理這些操作。

const createRouter = () => new Router({
  // mode: 'history', // require service support
  scrollBehavior: () => ({ y: 0 }),
  routes: constantRoutes
})

const router = createRouter()

// 重置路由
export function resetRouter() {
  const newRouter = createRouter()
  router.matcher = newRouter.matcher // reset router
}

用戶在經過登錄介面處理後，就會通過對應的Action獲取動態路由資訊（注意，這裡是先獲取動態菜單，然後過濾本地路由，即為動態路由資訊），獲得動態路由後，就設置前端所能訪問的路由集合即可，如下程式碼所示。

有了這些新的路由允許，前端系統的菜單才能夠正常運轉起來，否則即使介面展示了菜單，也不能訪問特定的視圖頁面而跳到了404頁面，因為路由沒有。

3、登錄的過程處理

前面大概介紹了路由的處理過程，其實我們路由資訊，應該需要從登錄介面開始講起。

以登錄介面為例，在用戶登錄處理後，需要先驗證用戶的帳號密碼，成功後繼續請求該用戶對應的動態菜單集合，並通過路由切換到對應的頁面或者首頁。

在Store/Modules/user.js模組裡面，定義了對應的登陸處理Action，如下所示

我們這裡忽略用戶登錄的檢驗和處理token的過程，主要關注動態菜單請求並設置路由的過程。

在我們需要攔截路由到達前的處理中，我們定義對應的路由資訊請求邏輯，如下所示。

router.beforeEach(async(to, from, next) => {

在處理菜單路由的對應模組裡面，我們定義了一個狀態用來承載這些重要資訊，如下定義State所示。

const state = {
  menuItems: [],
  routes: [],
  addRoutes: [],
  asyncRoutes: asyncRoutes
}

// 定義了路由和菜單的Mutation
const mutations = {
  SET_ROUTES: (state, routes) => {
    // var list = convertRoute(routes)
    routes.push({ path: '*', redirect: '/404', hidden: true }) // 此為默認錯誤路由

    state.addRoutes = routes
    state.routes = [].concat(routes)// constantRoutes.concat(routes)
  },
  SET_MENUS: (state, menus) => {
    state.menuItems = menus
  }
}

// 定義了生成動態路由的Action處理
const actions = {
  generateRoutes({ commit }, roles) {
    return new Promise(resolve => {
      getMenus().then(res => {
        const menus = res.data || [] // 統一通過介面獲取菜單資訊
        const routes = []

        menus.forEach(item => {
          filterRoutes(routes, item)
        })
        console.log(routes)// 列印路由

        commit('SET_ROUTES', routes)
        commit('SET_MENUS', menus)
        resolve(routes)
      });
    })
  }
}

最後返回對應的JS定義模組類資訊即可。

export default {
  namespaced: true,
  state,
  mutations,
  actions
}

在前端介面處理中，我們通過Element介面組件的方式展示動態菜單資訊，並結合菜單和路由的關係，實現菜單跳轉到對應視圖的處理過程。

我們來看看介面生成的動態菜單效果。

由於菜單動態展示和動態路由配合，因此既能在前端實現動態菜單的展示，又會根據菜單的集合刷新可訪問路由，兩者結合就可以順利打開對應的視圖頁面了。

再來回顧一下，菜單路由處理的大概的操作過程如下所示

Tags: 循序漸進VUE+Element