Skip to content

feat(docs): 顶栏导航按包显示版本标签#132

Merged
cc-hearts merged 1 commit into
mainfrom
feat/docs-header-version-labels
Jul 10, 2026
Merged

feat(docs): 顶栏导航按包显示版本标签#132
cc-hearts merged 1 commit into
mainfrom
feat/docs-header-version-labels

Conversation

@cc-hearts

Copy link
Copy Markdown
Member

🤔 本次变更属于 ...

  • ⭐️ 功能增强
  • 📝 站点 / 文档改进

🔗 相关 Issue

无。

💡 背景与方案

原先文档站顶栏右侧只有一个全局版本号 v{{ version }}(取自 @antdv-next/x),无法区分 Components / Markdown / Card / SDK / Skill 各子包的实际版本。

方案: 将全局版本号改为按包展示——在每个导航项正下方渲染对应包的版本标签。

  • header.ts:从各子包 package.json 读取 versionHeaderItem 新增可选 version 字段,并为 components / markdown / card / sdk / skill 五项填充;
  • header-navigation.vue:导航项改为纵向布局,标签下方渲染版本号,含 hover / active 配色过渡与移动端(≤767.99px)响应式回退为静态排列;
  • header-actions.vue:移除顶栏右侧原有的全局 v{{ version }}

效果:各包版本一目了然,无需进入页面即可从顶栏感知版本差异。

📝 变更日志

语言 变更日志
🇺🇸 英文 Show per-package version labels under top nav items instead of a single global version.
🇨🇳 中文 顶栏导航各项下方按包显示版本标签,替代原先单一的全局版本号。

将顶栏右侧单一全局版本号改为在各个包导航项(Components /
Markdown / Card / SDK / Skill)下方独立展示对应包版本:

- header.ts: 从各子包 package.json 读取 version,HeaderItem
  增加 version 字段并填充
- header-navigation.vue: 导航项改为 column 布局,下方渲染
  版本标签,含 hover/active 配色与移动端响应式
- header-actions.vue: 移除顶栏右侧全局 v{{ version }}
@cc-hearts cc-hearts merged commit b01f0fa into main Jul 10, 2026
1 check passed
@cc-hearts cc-hearts deleted the feat/docs-header-version-labels branch July 10, 2026 14:34
cc-hearts added a commit that referenced this pull request Jul 10, 2026
* feat(docs): 顶栏右侧按模块动态切换版本

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

- 新增 useActiveHeaderItem composable:按当前路由解析激活的导航项及对应子包 version
- header-navigation.vue:移除每个导航项下方的 versionTag 渲染与样式,恢复简洁横向导航
- header-actions.vue:右侧新增 a-select 版本切换器,currentVersion 跟随激活模块的 activeVersion 变化;无版本模块(研发/演示)自动隐藏;options 暂只含当前版本,为后续 versionList 多版本切换铺垫

* style(docs): 版本切换器去掉 v 前缀只显示版本号

* style(docs): 优化版本切换器宽度
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