Skip to content

feat(docs): 顶栏右侧按模块动态切换版本#134

Merged
cc-hearts merged 3 commits into
mainfrom
feat/header-dynamic-version-switch
Jul 10, 2026
Merged

feat(docs): 顶栏右侧按模块动态切换版本#134
cc-hearts merged 3 commits into
mainfrom
feat/header-dynamic-version-switch

Conversation

@cc-hearts

Copy link
Copy Markdown
Member

背景

#132 将版本以小标签形式展示在每个顶栏导航项下方。现希望对齐 antdv-next 主站风格,改为顶栏右侧的版本切换器,并且切换到不同模块时展示该模块对应子包的版本,同时为后续的多版本列表(versionList)切换做铺垫。

改动

1. 新增 useActiveHeaderItem composable

packages/docs/src/composables/use-header-active.ts

按当前路由解析激活的导航项,暴露 activeItem / activeKey / activeVersion,供顶栏导航与右侧版本切换器共用,避免重复计算。

2. header-navigation.vue

移除 #132 在每个导航项下方渲染的 versionTag(含绝对定位样式与移动端响应式),恢复为简洁的横向导航;activeKey 改由 composable 提供。

3. header-actions.vue(右侧动作区)

新增 a-select 版本切换器,参考 antdv-next 主站:

  • currentVersion 跟随激活模块的 activeVersion 变化(watch 同步),切换模块即自动切换显示的包版本
  • 当前模块无版本(研发 / 演示)时自动隐藏(v-if="currentVersion"
  • versionOptions 暂时只包含当前版本,为后续 versionList 多版本切换铺垫(替换为历史版本列表即可生效)
  • 样式:size="small" variant="filled" min-width: 86px,对齐主站

模块 → 版本映射

模块 子包 版本来源
组件 @antdv-next/x x/package.json
Markdown @antdv-next/x-markdown x-markdown/package.json
Card @antdv-next/x-card x-card/package.json
SDK @antdv-next/x-sdk x-sdk/package.json
Skill @antdv-next/x-skill x-skill/package.json
研发 / 演示 隐藏切换器

版本数据仍由 config/header.tsversion 字段统一维护。

验证

  • vp lint ✅ 0 warnings / 0 errors
  • vp check --fix ✅ 格式已规范;既有 2 个 x-markdown/vite.build.config.ts 类型错误为 main 上已存在(与本 PR 无关,CI 仅跑 vp test
  • vp test ✅ 43 files / 407 tests passed

后续

versionOptions 替换为各包的历史版本列表 + 切换跳转逻辑即可完成 versionList 多版本切换。

#132 在各导航项下方展示的版本小标签改为顶栏右侧的 a-select 版本切换器(对齐 antdv-next 主站风格),并随当前模块切换显示对应子包版本:

- 新增 useActiveHeaderItem composable:按当前路由解析激活的导航项及对应子包 version
- header-navigation.vue:移除每个导航项下方的 versionTag 渲染与样式,恢复简洁横向导航
- header-actions.vue:右侧新增 a-select 版本切换器,currentVersion 跟随激活模块的 activeVersion 变化;无版本模块(研发/演示)自动隐藏;options 暂只含当前版本,为后续 versionList 多版本切换铺垫
@cc-hearts cc-hearts merged commit 24b4256 into main Jul 10, 2026
1 check passed
@cc-hearts cc-hearts deleted the feat/header-dynamic-version-switch branch July 10, 2026 15:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant