vue-router + element-plus实现面包屑导航栏和路由标签栏

效果预览

首先,先解释一下什么是面包屑导航栏和路由标签栏。

如下图所示,面包屑导航栏就是展示当前所处路由信息和父辈路由信息的导航栏,它的作用是提示用户当前页面所在位置;路由标签栏就类似于浏览器的标签栏,每个标签对应一个路由页面,点击该标签可以进入该路由页面。

在这里解释一下,我所说的父辈路由是父路由的超集,对于一个子路由,它的父路由、它的父路由的父路由、它的父路由的父路由的父路由…都属于它的父辈路由。我也不知道这种叫法是否规范,反正大家理解这个意思就行。
面包屑、路由标签

然后展示一下效果:
这是我自己做的一个基于vue3+typescript的网站,后端是用golang写的,网站有查询微博、百度、凤凰历史热搜的功能,以及上传图片、创建相册、分享相册等云图床相关功能。这是网站预览地址gitee仓库地址。(ps:此网站并不是一个demo,而是具有完整前后端交互和一定功能的网站,需要注册并登陆才能使用,注册很简单,只需要设置用户名、账号、密码即可。**也可登陆测试账号: admin,密码: 123456。**但如果有两人同时登陆这个测试账号,那么后者会把前者挤下去,当然这种概率很小罢了。)

效果展示

对于侧边导航栏如何实现的,请移步这篇文章:vue-router + element-plus实现多层级路由的动态展示

在本文章中,我主要讲解如何实现面包屑导航栏和路由标签栏。

面包屑导航栏的实现

先讲一下大体思路:

  • 首先弄清楚面包屑导航栏要展示哪些数据
  • 然后想办法获取这些数据
  • 最后把数据应用到组件中

首先,面包屑展示哪些数据?

路由的结构其实就是一棵树,没有子路由的路由对应树中的一个叶子节点,面包屑导航栏中要展示的就是这个当前页面对应的子路由、以及该子路由所有的父辈路由

为了方便说明,我举个例子,现在有一个网页的路由结构如下图中所示,假如当前我们处于localhost:8080/earth/asia/china页面,那么当前页面的子路由就是中国,它有两个父辈路由分别是亚洲和地球,所以我们要在面包屑中展示的信息就是 “地球 / 亚洲 / 中国”
在这里插入图片描述
然后,如何获取这些数据?

扫描二维码关注公众号,回复: 15020601 查看本文章

在一棵树中,要获得一个叶子节点的所有父辈节点信息,可以从根节点开始进行dfs深度优先搜索,在搜索的过程中存一下在当前分支上搜过的路径,如果遇到叶子节点就把路径保存起来作为结果。

这种方法是一种可行方案,但其实还有更简单的方法。我们可以把这棵树线索化,在每个节点中存一下父节点的信息,那么就可以根据该节点直接获得父节点,进而获得父节点的父节点,父节点的父节点的父节点…,递归操作,就可以该节点获得所有父辈节点信息。

下面是从我的网站源码/src/router/index.ts中截取出来的代码,可以看到我在meta里自定义了一个parentRouteName属性,这个属性就是线索属性,我们可以借助这个属性获取该路由的父路由。

{
    
    
	path: 'weibo',
	name: 'Weibo',
	component: () => import('../views/hot/Weibo.vue'),
	meta: {
    
    
		description: '微博热搜查询',
		parentRouteName: "Hot",
		showInAside: true,
		showInHeader: true
	}
},

下面这个函数的作用是获取某个路由的所有父辈路由信息,参数name是子路由的名称,参数routes是路由数组,返回值是一个string数组,它的值是 […, 爷爷路由名称, 父亲路由名称, 子路由名称]。

依然沿用上面的例子,假如我们传入的name属性等于’china’,那么函数的返回值是[‘earth’, ‘asia’, ‘china’]

// 获取面包屑的路由名称数组
export function getNames(name: string, routes:RouteRecordNormalized[]): string[]{
    
    
    let names: string[] = []
    // 使用while循环进行递归操作,直至遍历到最顶级的父辈路由,然后退出循环
    while(true){
    
    
        names.push(name)
        let route = getRouteByName(name, routes) as RouteRecordNormalized
        let parentRoute = getRouteByName(route.meta?.parentRouteName as string, routes)
        if(parentRoute){
    
    
            name = parentRoute.name as string
            continue
        } 
        else{
    
    
            break
        }
    }
    return names.reverse()
}

最后,将数据写入element-plus提供的面包屑组件

获取了数据之后,接下来要做的就很简单了,只需要把数据写到面包屑组件里做展示即可,如下面代码所示。

还需要添加一个路由守卫,在每次路由跳转后都要更新面包屑里的数据。其实可以写成计算属性的,毕竟route对象和router对象都是响应式的。

下面的代码是从源码/src/components/layout/Header.vue里截出来的,想看完整的代码请访问gitee仓库地址

<template>
	<el-breadcrumb separator="/">
	  <el-breadcrumb-item 
	    v-for="description,index in descriptions"
	    :key="description"
	    :to="{ name: routeNames[index] }"
	    class="breadcrumb-item"
	  >
	    {
   
   {description}}
	  </el-breadcrumb-item>
	</el-breadcrumb>
</template>
<script setup lang="ts">
import {
      
       getNames, getDescriptions, getRouteByName } from '../../util/handleRoutes'
import {
      
      useRouter, useRoute, RouteRecordNormalized} from 'vue-router'
const router = useRouter()
const route = useRoute()
let descriptions = ref<string[]>([])
let routeNames = ref<string[]>([])

//获取面包屑的数据
routeNames.value = getNames(route.name as string, router.getRoutes()) 
descriptions.value = getDescriptions(routeNames.value, router.getRoutes())

//在每次路由跳转后,更新面包屑的数据
router.afterEach((to, from) => {
      
      
  //不知道为什么,进入页面时,会有两次路由跳转,route.name为空
  if(!route.name){
      
      
    console.log(route.name, route.meta)
    return
  }

  routeNames.value = getNames(route.name as string, router.getRoutes())
  descriptions.value = getDescriptions(routeNames.value, router.getRoutes())
})
</script>

路由标签栏的实现

和上面的思路类似,要实现路由标签栏,我们也是分三个步骤:

  • 首先,考虑路由标签栏需要哪些数据
  • 然后,如何获取这些数据
  • 最后,如何把这些应用到组件并展示出来

首先,路由标签栏需要哪些数据?

类比一下,浏览器标签栏存放的是曾经访问过的网页,那么很显然路由标签栏需要的数据就是曾经访问过的路由页面。

然后,如何获取访问过的路由页面?

我是这样做的,在pinia里定义一个routerStore,里面有个visitedRoutes属性,用来存放所有访问过的路由,它的初始值只包含首页对应的路由。

import {
    
     defineStore } from "pinia"
import {
    
     RouteRecordNormalized} from "vue-router"
import {
    
     router } from "../router"
import {
    
     getRouteByName } from "../util/handleRoutes"
let defaultRoute = getRouteByName('Home', router.getRoutes()) as RouteRecordNormalized
let visitedRoutes = [defaultRoute]
export const useRouteStore = defineStore('route', {
    
    
  // 推荐使用 完整类型推断的箭头函数
  state: () => {
    
    
    return {
    
    
      visitedRoutes
    }
  },
})

添加一个路由守卫,在每次路由跳转后,如果进的路由不存在于visitedRoutes,那么把这个路由添加到visitedRoutes里面。

router.afterEach((to, from) => {
    
    
  if(!to.meta.showInHeader){
    
    
    return
  }
  let result = routeStore.visitedRoutes.find(val => val.name == to.name)
  if(!result){
    
    
    routeStore.visitedRoutes.push(getRouteByName(to.name as string, router.getRoutes()) as RouteRecordNormalized)
  }
})

最后,把历史访问数据应用到组件里

这一步比面包屑的最后一步要复杂一些,因为路由标签的交互比较多,当路由标签被点击时,需要跳转到相应路由。当路由标签被关闭时,如果当前页面并不是要关闭的路由标签,那么直接关闭即可;如果当前页面时要关闭的路由标签,那么需要进行路由跳转,跳转到首页。
下面的代码是从源码/src/components/layout/Header.vue里截出来的,想看完整的代码请访问gitee仓库地址

<template>
  <div class="header-part-two">
    <el-tag
      v-for="visitedRoute in routeStore.visitedRoutes"
      :key="visitedRoute.name"
      :closable="visitedRoute.name != 'Home'"
      :disable-transitions="false"
      @close="handleClose(visitedRoute.name as string)"
      @click="goToRoute(visitedRoute.name as string)"
      @click.middle="handleClose(visitedRoute.name as string)"
      :class="{
     
     'active-tag': isActive(visitedRoute.name as string)}"
    >
      {
   
   { visitedRoute.meta?.description }}
    </el-tag>
  </div>
</template>
<script>
import {
      
      useRouter, useRoute, RouteRecordNormalized} from 'vue-router'
import {
      
       useRouteStore } from '../../store/route'
const routeStore = useRouteStore()
const router = useRouter()
const route = useRoute()
// 跳转
function goToRoute(name:string){
      
      
  router.push({
      
      name})
}
function isActive(name:string){
      
      
  return name == route.name 
}
// 关闭
function handleClose(routeName: string){
      
      
  if (routeName === 'Home') {
      
      
    return
  }
  routeStore.visitedRoutes = routeStore.visitedRoutes.filter(val => val.name != routeName)
  if(route.name == routeName){
      
      
    router.push('/')
  }
}
</script>

猜你喜欢

转载自blog.csdn.net/m0_52744273/article/details/129634837