Files
go-sms-V2/web/src/stores/tabs.ts
T
Tory eaecd83ab0
ci / test (push) Canceled after 0s
ci / web-test (push) Canceled after 0s
ci / build (push) Canceled after 0s
ci / deploy-dev (push) Canceled after 0s
Issue#2: 管理前端多标签导航+页签缓存(Gitea 工单:可独立关闭/一次全部关闭/切换后缓存)—— ①多标签导航=stores/tabs.ts(tab 身份=fullPath,参数页每实例一 tab 带 #id 后缀;home 固定不可关;登出 $reset 防跨角色残留;close 关当前回退相邻右邻优先/closeOthers/closeAll)+TagsBar.vue(纯原生元素守 G2 断言语义;✕独立关闭+中键关闭[auxclick button===1,@click.middle 对中键永不触发]+关闭其他+全部关闭;aurora token 风格 primary-soft 激活/圆角10px);②keep-alive 页签缓存=MainLayout router-view v-slot+include=cachedNames+key=fullPath;**29 个业务视图 defineOptions name=路由名**(28 新增+stats/profit 由 StatsProfitView 对齐——script setup 文件名推断名永不命中 include:15 个 index.vue 全叫 index/PascalCase≠kebab);ComingSoon(11 路由共用)刻意豁免(无本地状态,不缓存零副作用);③守门=view-cache-name.spec.ts 固化组件名=路由名约定(漏写=缓存静默失效,测试红而非线上)+verify-layout.mjs +5 项 tags-bar 断言(18→23)且凭据 env 化(SHOT_USER/SHOT_PASS 缺省 s2demo——admin 原密码首启打印一次不可知,硬编码 admin123 已不可登录 ISC:401);④门禁=eslint0/vue-tsc0/vitest 165(+17:tabs-store 7+守门 4+tags-bar 6)/build 9.99s chunk 剖面不变;verify-layout 23/23;Chrome 157 实机走查 17/17 含两项核心状态保留实证(结算页内 Tab 选中+筛选账号ID=2 切走切回均保留;截图 /tmp/issue2-*.png);验收单 issue2-frontend-tabs.md+CHANGELOG+memory-bank 回填
2026-11-16 12:35:42 +08:00

82 lines
3.9 KiB
TypeScript

// stores/tabs.ts — Issue#2 多标签导航(tags-view)状态。
//
// 设计口径(tab 身份=route.fullPath,缓存身份=组件名=路由名):
// - keep-alive :include 按**组件名**匹配,而 script setup 的文件名推断名
// (15 个 index.vue 全叫 "index";PascalCase 文件名 ≠ kebab 路由名)永不
// 命中——各业务视图必须 defineOptions({ name: <路由名> }),守门测试
// tests/view-cache-name.spec.ts 防新增页面漏写导致"缓存静默失效"。
// - tab 身份用 fullPath:参数页(account/:id、channel/edit/:id?)每实例
// 一 tab;query 变体亦独立成 tab(口径如此,验收单有记)。
// - ComingSoon 占位页(11 条路由共用)**豁免缓存**:无本地状态可保,
// 不写 defineOptions → include 永不命中 → 每次进入重挂载,零副作用。
// - 同名多实例(如 account/1 与 account/2)关闭其一时缓存条目随名保留,
// 最后一个同名 tab 关闭才真正释放(keep-alive 按名驱逐,有限驻留可接受)。
import { defineStore } from 'pinia'
import type { RouteLocationNormalizedLoaded } from 'vue-router'
export interface TabItem {
path: string // fullPath(tab 身份:去重锚+跳转目标)
name: string // 路由名(=组件名,keep-alive include 锚)
title: string // 标签文案(meta.title + 参数后缀)
affix?: boolean // 固定标签(home,不可关闭)
}
/** 固定标签:运营总览(五角色可达;刷新后的最小恢复集)。 */
const AFFIX_HOME: TabItem = { path: '/home', name: 'home', title: '运营总览', affix: true }
/** 参数页标题后缀:账号详情 #12 / 通道编辑 #7(无 id 的新建态不加后缀)。 */
function tabTitle(route: RouteLocationNormalizedLoaded): string {
const base = String(route.meta.title ?? '')
const id = route.params?.id
return id ? `${base} #${String(id)}` : base
}
/** 开标签判据:业务页(有 title+group);错误页(403/500/404)无 group 不开,
* 登录页在布局外、redirect 路由永不成为 resolved 终路由,均天然排除。 */
function isTabbed(route: RouteLocationNormalizedLoaded): boolean {
return typeof route.name === 'string' && !!route.meta.title && !!route.meta.group
}
interface TabsState {
visited: TabItem[]
}
export const useTabsStore = defineStore('tabs', {
state: (): TabsState => ({ visited: [{ ...AFFIX_HOME }] }),
getters: {
/** keep-alive include 列表:打开中的 tab 的路由名(=组件名,去重)。 */
cachedNames: (s): string[] => [...new Set(s.visited.map((t) => t.name))],
},
actions: {
/** 路由到达即登记(按 fullPath 去重;标题随参数刷新)。 */
addTab(route: RouteLocationNormalizedLoaded) {
if (!isTabbed(route)) return
const exists = this.visited.find((t) => t.path === route.fullPath)
if (exists) {
exists.title = tabTitle(route)
return
}
this.visited.push({ path: route.fullPath, name: String(route.name), title: tabTitle(route) })
},
/** 关闭单个标签;若关的是当前页则返回应跳转的相邻 tab path
* (右邻优先,末位取左邻),否则返回 null(无需导航)。固定标签不可关。 */
close(path: string, activePath: string): string | null {
const idx = this.visited.findIndex((t) => t.path === path)
if (idx < 0 || this.visited[idx]!.affix) return null
this.visited.splice(idx, 1)
if (path !== activePath) return null
const neighbor = this.visited[Math.min(idx, this.visited.length - 1)]
return neighbor ? neighbor.path : '/home'
},
/** 关闭其他(固定标签与当前页保留)。 */
closeOthers(keepPath: string) {
this.visited = this.visited.filter((t) => t.affix || t.path === keepPath)
},
/** 全部关闭(仅固定标签保留);返回回退目标。 */
closeAll(): string {
this.visited = this.visited.filter((t) => t.affix)
return this.visited[0]?.path ?? '/home'
},
},
})