唯一合法方案是 ruby+rt 结构:ruby 包裹 rb(汉字)和紧随其后的 rt(拼音),缺一不可;多音字须按语境逐字标注,禁用 span、data-pinyin 或 JS 模拟。

多音字标注不能靠 title、伪元素或 JS 动态插入拼音来“模拟”,必须用合法的 HTML 语义结构——ruby + rt 是唯一被 W3C 标准认可的方案。
为什么不用 span 套拼音或 data-pinyin 属性
这类写法看似灵活,但破坏了可访问性与语义一致性:屏幕阅读器不会读出 data-pinyin 的值;搜索引擎无法识别这是注音行为;拼音和汉字在 DOM 中无父子关系,CSS 控制基线对齐困难;更关键的是,它绕开了 HTML 对东亚文字注音的原生支持机制。
ruby 结构必须严格满足嵌套规则
合法结构只有一种:ruby 包裹汉字(rb),rt 紧跟其后作为子元素。不能省略 rb,也不能把拼音塞进 rp 里凑数。
-
<ruby><rb>长</rb><rt>zhǎng</rt></ruby>✅ 正确:汉字在rb,拼音在rt -
<ruby>长<rt>zhǎng</rt></ruby>❌ 错误:缺少rb,语义断裂 -
<ruby><rt>zhǎng</rt><rb>长</rb></ruby>❌ 错误:rt必须紧随rb,顺序错乱将导致渲染异常
多音字需按实际语境单独标注,不能复用同一拼音
一个字在不同词中读音不同,ruby 必须逐字绑定。比如“发”在“发展”和“头发”中读音不同,就得写两套独立结构:
立即学习“前端免费学习笔记(深入)”;
<ruby><rb>发</rb><rt>fā</rt></ruby><ruby><rb>展</rb><rt>zhǎn</rt></ruby> <ruby><rb>头</rb><rt>tóu</rt></ruby><ruby><rb>发</rb><rt>fà</rt></ruby>
不要试图用 JS 统一替换或 CSS 控制显示逻辑——那会让语义退化为视觉装饰。
兼容性与样式微调要点
现代浏览器对 ruby 支持良好,但默认样式较弱。需用 CSS 显式控制 rt 字体大小和行高:
- 加
ruby { line-height: 1.2; }防止拼音被截断 - 设
rt { font-size: 75%; }是最稳妥的缩放比例 - 避免用
position: relative手动偏移rt——这会破坏语义层叠关系,且在 zoom 缩放时错位 - 不建议给
rb加display: inline-block——会打断内联流,影响换行行为
真正难的不是写出结构,而是坚持让每个字都对应一个明确语境下的读音。一旦偷懒合并处理,语义就塌了一半。



















