Skip to content

fix: 修复文档站历史版本切换异常#929

Open
yunye-ygx wants to merge 2 commits into
dromara:devfrom
yunye-ygx:feature-fix
Open

fix: 修复文档站历史版本切换异常#929
yunye-ygx wants to merge 2 commits into
dromara:devfrom
yunye-ygx:feature-fix

Conversation

@yunye-ygx

Copy link
Copy Markdown

变更说明

本次修改统一了文档站的版本切换逻辑,修复了部分历史版本页面切换异常的问题。

主要变更

  • 将文档页中的版本下拉框改为统一脚本渲染,避免不同页面分别维护版本列表
  • 统一维护版本列表与跳转路径
  • 兼容 /doc.html/doc/index.html 两种历史文档路径
  • 切换版本时保留当前 hash 路由
  • 补充回归测试,覆盖旧版本切换最新版、旧版本之间切换等场景

修复问题

  • 部分旧版本页面切换到最新版时无响应
  • 旧版本之间切换时路径不一致
  • 历史版本页面的版本切换行为不统一

验证方式

  • 运行:
    node --test sa-token-doc/static/doc-version-switcher.test.cjs
  • 本地验证:
    • v1.30.0 -> 最新版 可以正常跳转
    • 多个旧版本之间可以正常切换
    • 任意旧版本都可以正常切回最新版

yunye added 2 commits April 18, 2026 17:57
- 为版本选择下拉菜单中的链接添加了缺失的前导斜杠
- 确保版本跳转路径正确,避免页面跳转错误
- 保持文档结构和样式未变,提高用户访问体验
- 移除静态版本选择下拉框的硬编码内容
- 新增版本切换器脚本,实现动态生成版本选项
- 支持最新版本和历史版本的统一版本列表展示
- 保证切换版本时保持当前页面hash值不变
- 添加多个单元测试覆盖版本切换器逻辑
- 页面初始化时自动加载版本切换器并绑定事件
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