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;
}

这里的“上方”和“下方”是相对于书写模式理解的。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;
}

用特性检测准备可读性降级
新 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 增强样式,文章和组件在旧环境中也更容易保持可读。
-
130 收藏
-
224 收藏
-
412 收藏
-
132 收藏
-
Golang · Go教程 | 3个月前 | HTTP · go · 浏览器 · Go Beacon API navigator.sendBeacon 页面关闭上报 Go HTTP 接收 Beacon keepalive fetch140 收藏
-
250 收藏
-
325 收藏
-
149 收藏
-
文章 · 前端 | 41分钟前 | 前端 · javascript · 浏览器API · Canvas ResizeObserver devicePixelContentBoxSize device-pixel-content-box181 收藏
-
文章 · 前端 | 42分钟前 | 性能优化 · javascript · 前端开发 · root IntersectionObserver rootMargin threshold 前端可见性 rootBounds scrollMargin469 收藏
-
456 收藏
-
文章 · 前端 | 1小时前 | javascript · 异步编程 · 前端开发 · AbortController ReadableStream 流式响应 Response.Body Fetch API getReader reader.read107 收藏
-
237 收藏
-
110 收藏
-
443 收藏
-
187 收藏
-
450 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习