多音字标注必须一对一:每个只能对应一个,且须依语境人工判定唯一读音,如“长度”用cháng、“长大”用zhǎng;禁止在单个中堆叠多音或依赖自动注音。

多音字不能塞进同一个 <rt></rt> 里
常见错误是写成 <ruby>长<rt>cháng/zhǎng</rt></ruby>,这会让屏幕阅读器朗读为“cháng/zhǎng”,语义混乱,也违反 W3C 对 <rt></rt> 的“一对一”要求。浏览器不会自动选音,更不会根据上下文切换——它只照单全收。
真正可行的做法是:人工判断语境后,只保留该语境下唯一正确的读音。例如:
- “长度”中必须用
<ruby>长<rt>cháng</rt></ruby> - “长大”中必须用
<ruby>长<rt>zhǎng</rt></ruby>
如果原文需同时呈现两种可能(比如教学对比场景),<ruby></ruby> 不适用;应改用普通 HTML + data-pinyin 属性或并列 <span></span>,再靠 CSS 控制显示逻辑。
<ruby></ruby> 不支持自动分词或上下文感知
HTML 规范没给 <ruby></ruby> 加任何语义推理能力。它不认“长”是形容词还是动词,也不管前后有没有“大”“度”这些字。所谓“多音字标注”,本质是人工预处理任务——你得先读完整句,查词典,定读音,再手写对应 <rt></rt>。
立即学习“前端免费学习笔记(深入)”;
容易踩的坑:
- 把整词包进一个
<ruby></ruby>:如<ruby>否极泰来<rt>pǐ jí tài lái</rt></ruby>—— 错,必须拆成四个独立<ruby></ruby> - 用空格或斜杠分隔多个拼音:
<rt>pǐ / fǒu</rt>—— 错,声调符号和字母必须构成合法 Unicode 拼音,且仅一个音节 - 依赖 JS 自动注音后直接塞进
<rt></rt>—— 危险,AI 注音准确率通常不到 90%,错音会直接暴露给读屏用户
教学场景下需要双音并列时怎么办
当目标是展示“这个字在不同词里怎么读”,<ruby></ruby> 不是工具,而是结果容器。正确路径是:
- 用普通段落写两行例词:
<p>长度:<ruby>长<rt>cháng</rt></ruby><br>长大:<ruby>长<rt>zhǎng</rt></ruby></p> - 或加
data-pinyin备用:<span data-pinyin="cháng zhǎng">长</span>,再用 JS/CSS 实现点击切换(但注意:这已脱离原生可访问性) - 避免用
<rp></rp>做“双音提示”:<rp>(cháng/zhǎng)</rp>在现代浏览器中会被隐藏,起不到教学作用
真正难的不是怎么写标签,而是怎么确保每个 <rt></rt> 都经得起语音合成器朗读、经得起残障用户依赖——这要求你在写代码前,先查《现代汉语词典》或《普通话异读词审音表》。



















