Skip to content

fix: 修正带注音歌词行的基线对齐 - #4

Merged
imsyy merged 1 commit into
SPlayer-Dev:mainfrom
Xpercent:fix/ruby-baseline-alignment
Oct 11, 2026
Merged

imsyy merged 1 commit into
SPlayer-Dev:mainfrom
Xpercent:fix/ruby-baseline-alignment

Conversation

@Xpercent

@Xpercent Xpercent commented Oct 4, 2026

Copy link
Copy Markdown
Contributor

改动类型

  • 新功能(feat)
  • 缺陷修复(fix)
  • 重构 / 优化(不改变对外行为)
  • 文档(docs)
  • 其他(请在「改动说明」中注明)

是否包含破坏性变更

  • 是(请在「改动说明」中详细描述)
  • 否

改动说明

开启「显示词内注音」(showRuby),且渲染引擎为默认时,带注音的单词会比同一行其它文字低几个像素,且偏移量随歌词字号线性放大。

原因是 .lp-main > span { vertical-align: middle }:注音会让 <ruby> 的盒子变高,而 middle 是按盒子中心对齐的,于是这个单词整体下沉。同文件里 .lp-word-roman 与 .lp-emp-wrapper 本来就各自覆盖成了 vertical-align: bottom,只有这条基础规则是 middle,看起来是遗漏。

改为 bottom 后整行按底边对齐,带不带注音都齐平,也与 AMLL 渲染器的做法一致(AMLL 把注音用 flex 列排在文字上方 + vertical-align: bottom,所以没有这个问题)。

改动仅一处 CSS 声明 + 一行说明注释,不涉及引擎逻辑与对外 API。

关联 Issue

无

测试情况

在 Chromium(Electron 内核)下用同一份构建产物做 A/B 对照,只切换这一条声明,用 Range.getBoundingClientRect() 量文字实际框底边:

歌词字号 middle(改动前) bottom(改动后)
16px 偏低 3.00px 0.00px
32px 偏低 4.50px 0.00px
56px 偏低 7.50px 0.00px

另外确认:注音文本仍完整可见;歌词行框高度未变化;无注音的普通行不受影响。

仓库自检命令均通过:pnpm test(34 用例)、pnpm lint、pnpm typecheck、biome format 无待格式化改动。测试平台为 Windows 11。

补充说明一种不可行的写法,供审查参考:把 rt 绝对定位到文字上方虽然也能消除偏移,但引擎给每个单词单独设置了 mask-image + mask-size: <宽度>px 100%,超出 span 盒子的注音会被遮罩整块裁掉——计算样式仍是 visible,实际却看不见,因此没有采用。

截图 / 录屏

before
image

after
image

(改前 / 改后各一张,同一首带 [kana:] 注音的日语 QRC 歌词,歌词引擎选「默认」)

自查清单

  • 本 PR 只包含一个主要功能 / 修复,没有夹带无关改动
  • 已在本地完整测试通过;AI 生成的代码同样自行测试并审阅过,未做未经验证的提交
  • 已运行 pnpm format,并确认 pnpm typecheck、pnpm lint 通过
  • 改动涉及原生模块时已 pnpm build:native 验证;未手写 native/*/index.d.ts(本仓库无原生模块,不适用)
  • 已向 dev 分支提交(本仓库无 dev 分支,目标为 main)

@imsyy
imsyy merged commit a391850 into SPlayer-Dev:main Oct 11, 2026
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.

2 participants