登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  前端

CSS ruby-position 怎样控制注音标记的位置

来源:17golang原创

时间:2026-11-17 01:20:30 247浏览 收藏

做日文读音、中文注音或古籍校注时,正文和注音经常需要保持在同一个语义单元里。HTML 的 可以表达这种对应关系,而 CSS ruby-position 负责决定注音放在正文上方、下方,还是字符侧边。最常用的写法是给 ruby 容器设置 over 或 under;需要逐字符显示注音符号时,再考虑 inter-character。

官方资料:https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/ruby-position

先把文字和注音放进同一个 ,再用 ruby-position 选择布局方向。普通横排标题优先从 over 开始,注音符号这类逐字符标注才使用 inter-character;多级标注则需要单独理解默认的 alternate。

先把 ruby、rb 和 rt 对应起来

ruby-position 只改变注音的位置,不会替你建立正文与注音的关系。最小结构里,rb 表示基础文字,rt 表示与它对应的注音。这样写的好处是:即使位置样式没有生效,读者仍能看到一段有语义的文字和注音。

東京(とうきょう)

rp 不是位置控制属性,但它能作为旧环境中的文本提示。现代环境通常会按 ruby 布局处理 rt,不需要把注音改成绝对定位元素,否则正文换行和字体变化时很容易失去对应关系。

用 over 和 under 控制横排注音

对横向排版的普通读音标注,over 会把注音放到正文上方,under 会把注音放到正文下方。把属性写在 ruby 上,规则会覆盖这一组注音,而不是散落在每个 rt 上。

.reading {
  /* 让短注音稳定显示在正文上方,适合日文读音标注。 */
  ruby-position: over;
}

.glossary-reading {
  /* 词汇表需要把解释放到正文下方时,使用 under。 */
  ruby-position: under;
}
ruby、rb、rt 与 ruby-position over、under、inter-character 的静态关系说明图
图1:说明图。HTML 结构提供正文和注音的对应关系,ruby-position 再把注音映射到上方、下方或字符侧边。

这里的“上方”和“下方”是相对于书写模式理解的。CSS 规范会根据水平或垂直书写方向解释位置,因此不要把它简单等同为永远固定的屏幕 top 和 bottom。文章关注的是 ruby 注音布局,不建议用 top、left 等物理偏移替代它。

inter-character 适合逐字符注音

inter-character 的用途和 over、under 不同:它把注音放到基础文字字符的侧边,主要服务于注音符号(bopomofo、zhuyin fuhao)这类逐字符标注。它不是“把整段注音挪到右边”的通用布局开关,使用前要先确认正文和注音确实是一对一或近似逐字符关系。

你ㄋㄧˇ好ㄏㄠˇ
.zhuyin {
  /* inter-character 是逐字符注音场景,不是普通标题的默认选择。 */
  ruby-position: inter-character;
}

在垂直书写或不同文字方向下,视觉上的“侧边”会随书写模式变化。若设计稿要求固定的屏幕方向,应该先确定 writing-mode 和阅读方向,再决定是否使用这个值。

理解 alternate 与多级注音

ruby-position 的初始值是 alternate。它主要用于同一组 ruby 中存在多级注音容器的情况,让不同层级在正文两侧交替布置。单层注音时,显式写出 over 或 under 更容易阅读和维护;不要因为默认值叫 alternate,就把所有普通读音都交给它。

漢かん汉字
.multi-reading {
  /* 多级标注保留默认交替语义;单级内容不要依赖这个默认值。 */
  ruby-position: alternate;
}
alternate、多级 rtc、writing-mode 与 ruby-position 兼容边界的静态关系说明图
图2:结构图。多级标注、书写方向和特性检测属于不同边界,不能用普通的 over/under 示例代替全部语义。

用特性检测准备可读性降级

新 CSS 属性可能在旧浏览器或特定排版引擎中没有完整实现。降级的重点不是手动模拟每个像素,而是保留文字内容、提供合理的默认布局,并把增强样式放在特性检测之后。

.reading {
  /* 默认样式先保证正文和注音仍然可读。 */
  font-size: 1rem;
}

@supports (ruby-position: over) {
  .reading {
    /* 支持该属性时再启用上方注音。 */
    ruby-position: over;
  }
}

@supports (ruby-position: inter-character) {
  .zhuyin {
    /* 注音符号场景单独增强,不影响普通 ruby。 */
    ruby-position: inter-character;
  }
}

如果项目必须在多个浏览器中保持一致,还要把字体、字号、书写模式和多级注音作为整体回归项。不要把 @supports 的结果写成“布局一定正确”:它只说明解析器接受该声明,不代表每种复杂 ruby 结构都拥有相同的排版效果。

常见问题

为什么设置了 ruby-position 但注音看起来没有移动?

先确认选择器命中了 ruby 容器,而不是拼写成了普通的 position。再检查结构是否包含对应的 rt,以及当前书写模式是否让“上方、下方、侧边”的视觉方向发生变化。

普通日文读音应该使用 inter-character 吗?

通常不应该。普通词语读音更适合 over 或 under,inter-character 更适合注音符号等逐字符标注。是否采用还要看正文与注音的对应粒度。

可以用绝对定位代替 ruby-position 吗?

不建议。绝对定位脱离文字流,遇到字体变化、换行或响应式宽度时容易错位;ruby 元素的语义结构和 CSS ruby 布局更适合表达正文与注音的关系。

小结

使用 ruby-position 时,可以按三个判断快速落地:整段读音优先选择 over 或 under;逐字符注音符号考虑 inter-character;多级注释才需要理解 alternate 和 rtc。先保证 ruby、rb、rt 结构清晰,再用 @supports 增强样式,文章和组件在旧环境中也更容易保持可读。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>