多音字必须拆成独立单元,因浏览器仅在与一一对应时触发注音逻辑;共用容器会导致多音丢失、错位或无注音。

多音字必须拆成独立 <ruby></ruby> 单元,不能共用一个容器——这是浏览器渲染拼音的硬性前提
为什么一个 <ruby></ruby> 只能包一个字
浏览器只在 <rb></rb> 和 <rt></rt> 成对出现且一一对应时,才触发注音布局逻辑。写成 <ruby>长<rt>zhǎng</rt><rt>cháng</rt></ruby> 会直接忽略第二个 <rt></rt>,只显示第一个读音;更糟的是写成 <ruby>长<rt>zhǎng</rt><rt>cháng</rt>大</ruby>,会导致“大”字完全无注音,因为没套 <rb></rb>。
常见错误包括:
- 把两个读音塞进同一个
<rt></rt>:如<rt>zhǎng/cháng</rt>—— 浏览器当普通文本渲染,不识别斜杠分隔 - 漏掉
<rb></rb>只留<rt></rt>:如<ruby>长<rt>zhǎng</rt></ruby>—— 没有基文字锚点,<rt></rt>不上标、不定位 - 用空格或换行分隔多音:
<rt>zhǎng cháng</rt>—— 空格会被压缩, 在缩放后易错位
<ruby></ruby> + <rb></rb> + <rt></rt> 的最小合法单元
每个汉字必须单独包裹在 <rb></rb> 中,并配一个专属 <rt></rt>。多音字本质是多个独立字义单位,不是视觉排版问题。
立即学习“前端免费学习笔记(深入)”;
正确写法示例:
<ruby><rb>长</rb><rt>zhǎng</rt></ruby>大 <ruby><rb>长</rb><rt>cháng</rt></ruby>度
注意点:
-
<rb></rb>必须紧贴汉字,不能有空格或换行,否则可能被解析为文本节点而非基文字 -
<rt></rt>内容建议纯拼音,避免夹杂声调符号以外的字符(如括号、斜杠) - 如果上下文需强调某读音为主,可用 CSS 给对应
<rt></rt>加font-weight: bold,但不可删减结构
混排英文/数字时怎么处理多音字
HTML 注音只作用于汉字,其余字符默认不参与 <ruby></ruby> 布局。所以“第123页”中,只需给“第”和“页”加注音,“123”保持原样。
安全写法:
<ruby><rb>第</rb><rt>dì</rt></ruby>123<ruby><rb>页</rb><rt>yè</rt></ruby>
容易踩的坑:
- 把数字也塞进
<rb></rb>:如<rb>123</rb>—— 数字无读音,<rt></rt>会悬空,部分读屏软件报错 - 跨字符合并
<ruby></ruby>:如<ruby>第123页<rt>dì yè</rt></ruby>—— 整个字符串被当基文字,拼音无法对齐单字 - 用
<rp></rp>包裹多音选项:如<ruby>长<rp>(zhǎng)</rp><rp>(cháng)</rp></ruby>——<rp></rp>只是兼容 fallback 括号,不提供语义区分
最易被忽略的一点:动态生成时,如果后端拼接字符串没做字符级切分,很容易把“长”字当成普通文本流直接插入,漏掉 <rb></rb> 标签——这种缺失不是样式问题,是结构失效,连带影响 SEO 和读屏支持。



















