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

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











