feat: page-tab default tab supports internationalized interpolation#1860
feat: page-tab default tab supports internationalized interpolation#1860Wxh16144 wants to merge 2 commits intoumijs:masterfrom
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
PeachScript
left a comment
There was a problem hiding this comment.
这么改可能会有 Breaking Change,页面标题和该页面所属的第一个 Tab 的标题是两个概念,这个方案会使得现有使用约定式 Tab 的项目第一个 Tab 的标题都被默认改变,这其实也会影响全局文档 Tab 的一致性
以及页面级的自定义暂时没想清楚是否要支持,目前个人是倾向于不支持的,以避免影响全局文档 Tab 的一致性;如果讨论下来需要支持的话,应该要新开一个 FrontMatter 配置项来规避 Breaking Change
|
更新了一个版本, 默认将读取到的 frontmatter 传递给国际化,开发者可以通过修改国际化文案配合自己约定 frontmatter ,实现自定义。 |
什么场景下用户需要把 FrontMatter 的数据作为默认 Tab 标题的一部分 👀 |
哈哈哈, 没有 feature request。 |
|
没有实际场景的话建议先不加,一个站点的默认 Tab 的语义理应是全局统一的,框架留出这个口子就很可能引导用户创建出不一致的默认 Tab 标题,这会增加文档访问者的理解成本 |
约定式 Tab 的设计场景是有附属给默认文档的 Tab 内容,内容是主次关系,但你提到的场景是分类,内容是并列关系,所以和约定式 Tab 的定位是有区别的
侧边栏和搜索会用到 我感觉这个场景用二级导航更合适,因为 |


🤔 这个变动的性质是?/ What is the nature of this change?
🔗 相关 Issue / Related Issue
💡 需求背景和解决方案 / Background or solution
需求背景
社区反馈群反馈 tabs 第一个按钮标题无法修改。
解决方案
读取当前页面 frontmatter 信息。优先使用 title ,其次使用国际化 title在默认 tab 保持国际化语言情况下,支持国际化插值来自定义第一个标题。
example:
dumi/src/client/theme-default/locales/en-US.json
Line 35 in 0ec05de
proview:
📝 更新日志 / Changelog