Vue / 系统课时

多标签页导航

多标签页导航

企业后台的多标签页本质上不是“多放几个按钮”,而是把路由历史、标签状态和页面实例统一起来。本节用集中式状态管理创建、切换、关闭与刷新,并让所有状态变化最终以 Vue Router 的成功导航为准,避免标签高亮与实际页面错位。

学习目标

  • 设计支持创建、切换、关闭和刷新的标签状态模型。
  • 让标签状态与 Vue Router 保持可追踪的同步关系。
  • 正确处理关闭当前标签、动态路由和页面刷新等边界情况。

先确定标签状态的唯一来源

推荐把“当前路由”视为页面真实位置,把 Pinia 中的标签集合视为路由的派生状态。用户点击标签时先调用 router.push(),等导航成功后再由 afterEach 更新活动标签;这样权限守卫、重定向或导航失败都不会造成假激活。

每个标签至少保存 key、title、fullPath 和 closable。若业务允许同一路由的不同参数同时打开,例如 /orders/1001 与 /orders/1002,可以直接使用 fullPath 作为默认 key;若产品要求只保留一个“订单详情”标签,则应改成按路由名生成稳定键。

多标签页导航与路由同步时序

用 Pinia 管理标签状态

下面是片段示例,依赖已安装的 pinia 与 vue-router。Store 只维护标签状态,不直接导入 Router,从而避免路由模块与状态模块互相引用。

ts
import { defineStore } from 'pinia'
import { computed, ref } from 'vue'

export interface TabItem {
  key: string
  title: string
  fullPath: string
  closable: boolean
}

export const useTabStore = defineStore('tabs', () => {
  const tabs = ref<TabItem[]>([])
  const activeKey = ref('')
  const refreshVersion = ref<Record<string, number>>({})

  function syncFromRoute(tab: TabItem) {
    const index = tabs.value.findIndex(item => item.key === tab.key)

    if (index === -1) {
      tabs.value.push(tab)
    } else {
      // 路由标题可能变化,已有标签也覆盖为最新信息。
      tabs.value[index] = tab
    }

    activeKey.value = tab.key
  }

  function remove(key: string) {
    const index = tabs.value.findIndex(item => item.key === key)
    if (index >= 0) tabs.value.splice(index, 1)
  }

  function refresh(key: string) {
    refreshVersion.value[key] = (refreshVersion.value[key] ?? 0) + 1
  }

  const activeTab = computed(
    () => tabs.value.find(item => item.key === activeKey.value)
  )

  return {
    tabs,
    activeKey,
    activeTab,
    refreshVersion,
    syncFromRoute,
    remove,
    refresh,
  }
})

预期结果

text
进入一个可展示的路由时,标签集合中至多存在一个相同 key 的标签,并且 activeKey 与当前路由对应。
重复进入相同 key 的路由不会重复创建标签。
调用 refresh 时只增加对应标签的 refreshVersion,不额外写入浏览器历史记录。

在路由层完成同步与关闭

应用安装 Pinia 后,只注册一次 router.afterEach,把成功到达的路由转换为标签。标签点击直接调用 router.push(tab.fullPath),而不是先手动修改 activeKey。

关闭非活动标签可以立即删除;关闭活动标签则应先找到右侧优先、左侧兜底的相邻标签,完成导航后再删除旧标签。这样如果权限守卫拒绝导航,当前页面对应的标签仍然存在。

ts
import type { Router } from 'vue-router'
import { useTabStore } from './tab.store'

export function installTabNavigation(router: Router) {
  const store = useTabStore()

  router.afterEach(to => {
    if (to.meta.hideInTabs === true) return

    store.syncFromRoute({
      key: to.fullPath,
      title: String(to.meta.title ?? to.name ?? '未命名页面'),
      fullPath: to.fullPath,
      closable: to.meta.affix !== true,
    })
  })

  async function closeTab(key: string) {
    const index = store.tabs.findIndex(item => item.key === key)
    if (index < 0) return

    if (store.activeKey !== key) {
      store.remove(key)
      return
    }

    const candidates = store.tabs.filter(item => item.key !== key)
    const fallback = candidates[Math.min(index, candidates.length - 1)]

    // 活动页先成功离开,再删除旧标签,保证状态与真实路由一致。
    await router.push(fallback?.fullPath ?? '/')
    store.remove(key)
  }

  return { closeTab }
}

预期结果

text
关闭非活动标签:当前 URL 和页面保持不变。
关闭活动标签:优先切到原位置右侧标签,没有右侧时切到左侧,全部关闭时回到 /。
若导航被守卫拒绝,router.push 抛出或返回导航失败结果,旧活动标签不会提前被删除。

刷新页面而不是重复导航

“刷新标签”通常表示重建当前业务组件,而不是再次执行相同的 router.push()。可以把 route.fullPath 与 refreshVersion[route.fullPath] 组合成 RouterView 中组件的 key;调用 Store 的 refresh() 后版本增加,当前页面实例就会重新创建并重新执行数据加载逻辑。

如果项目使用 KeepAlive,刷新还要同步处理缓存名单,否则旧实例可能继续留在缓存中。常见做法是维护可缓存组件名集合,刷新时临时移除当前组件名,在下一次渲染后再恢复,从而实现针对单个标签的缓存失效。

处理动态路由和持久化边界

是否持久化标签取决于业务。普通后台通常只保存能够重建的 fullPath 和必要展示信息,浏览器重新加载后再使用当前权限路由表过滤一次;不要直接恢复已经失效或无权访问的页面。

动态路由还要明确“一个参数一个标签”还是“同一路由只保留一个标签”。前者适合同时对比多个详情页,后者更节省空间。这个规则应集中在标签 key 的生成策略中,而不是散落在各页面组件里。只要标签键、成功导航同步和关闭回退三条规则保持统一,多标签页就能稳定地与路由和页面实例协作。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

多标签页导航

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通