多音字必须按语境拆分为独立单元并用包裹,禁用斜杠分隔或数字标调;声调须用Unicode字符,轻声不加符号仅缩放;每个组合代表确定语义,需人工查证词典。

多音字必须人工判断上下文,不能靠自动拼接或斜杠分隔——否则语义断裂、读屏器失效、排版错位。
多音字必须拆成独立 单元,不能合并拼音
浏览器和语音引擎只认“一对一”结构。写成 长 看似省事,实际会让读屏软件卡住、CSS 无法单独控制声调颜色、Safari 渲染时拼音挤出基字范围。
- 正确做法:按语境拆开,每个读音单独包裹,例如「长度」用
长度,「长大」用长大 - 动态生成时(如用
pinyin-pro),别直接把数组 join(' / ') 塞进;应根据上下文词性/词典匹配结果,选唯一拼音输出 - 若需保留多音备选(如教学场景),改用
data-pinyin属性存备用值:长,再由 JS 控制切换
不可省略,否则 Safari 对齐失效、轻声缩放错位
看似多写一层标签麻烦,但 是 Safari 和旧 Edge 中 ruby-align 和 font-size 生效的前提锚点。漏掉它, 就成了“飘着的拼音”,尤其在轻声处理(rt[data-tone="light"] { font-size: 0.55em; })时会整体偏移。
- 单字也必须套
:,不是重 重 - 多音并列标注(如「重庆」的「重」字需同时标两个音),必须用多个
+并排:重 重 - Vue/React 中注意:
和必须是的**直接子节点**,中间不能插或条件渲染空格
声调与轻声必须用 Unicode 字符,禁用数字标调
Chrome 和 Firefox 对 zhong1 这类数字标调能勉强渲染,但 Safari 17.4+ 在 contenteditable 区域里会截断、Android WebView 可能完全不显示声调位置。更关键的是:数字标调无法用 CSS 单独给第四声上色(.tone4 { color: #e74c3c; })。
- 必须用 Unicode 声调符:
cháng、zhǎng、hào,不是chang2、zhang3、hao4 - 轻声不写声调符号,只用小写字母:
men(不是mēn或men5),再配合rt[data-tone="light"] { font-size: 0.55em; } - 动态生成时检查库输出:pinyin-pro 默认返回 Unicode,但 pinyin-js 需显式设
style: pinyin.STYLE_TONE,否则可能返回数字格式
最易被忽略的一点:多音字标注不是“技术问题”,而是“语义决策问题”。你写的每一组 ,都在告诉浏览器和读屏器“这个词在这里就读这个音”。一旦写错,修复成本远高于写对——因为要重新走无障碍测试、SEO 重爬、用户反馈闭环。所以别图快,先查《现代汉语词典》或权威语料库,再落笔。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











