当前位置:首页 > 文章列表 > 文章 > 前端 > CSS ruby-position 怎样控制注音标记的位置

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

来源:17golang原创 2026-11-17 01:20:30 0浏览 收藏

做日文读音、中文注音或古籍校注时,正文和注音经常需要保持在同一个语义单元里。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删除
CSS scrollbar-color 怎样给滚动区域设置主题色CSS scrollbar-color 怎样给滚动区域设置主题色
上一篇
CSS scrollbar-color 怎样给滚动区域设置主题色
WebSocket binaryType 怎样决定二进制消息的返回类型
下一篇
WebSocket binaryType 怎样决定二进制消息的返回类型
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1057次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1059次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1223次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1165次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1009次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码