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

多音字必须人工判断上下文,不能靠自动拼接或斜杠分隔——否则语义断裂、读屏器失效、排版错位。
多音字必须拆成独立 <ruby></ruby> 单元,不能合并拼音
浏览器和语音引擎只认“一对一”结构。写成 <ruby>长<rt>cháng/zhǎng</rt></ruby> 看似省事,实际会让读屏软件卡住、CSS 无法单独控制声调颜色、Safari 渲染时拼音挤出基字范围。
- 正确做法:按语境拆开,每个读音单独包裹,例如「长度」用
<ruby>长<rt>cháng</rt></ruby><ruby>度<rt>dù</rt></ruby>,「长大」用<ruby>长<rt>zhǎng</rt></ruby><ruby>大<rt>dà</rt></ruby> - 动态生成时(如用
pinyin-pro),别直接把数组 join(' / ') 塞进<rt></rt>;应根据上下文词性/词典匹配结果,选唯一拼音输出 - 若需保留多音备选(如教学场景),改用
data-pinyin属性存备用值:<ruby data-pinyin="cháng, zhǎng">长<rt>cháng</rt></ruby>,再由 JS 控制切换
<rb></rb> 不可省略,否则 Safari 对齐失效、轻声缩放错位
看似多写一层标签麻烦,但 <rb></rb> 是 Safari 和旧 Edge 中 ruby-align 和 font-size 生效的前提锚点。漏掉它,<rt></rt> 就成了“飘着的拼音”,尤其在轻声处理(rt[data-tone="light"] { font-size: 0.55em; })时会整体偏移。
- 单字也必须套
<rb></rb>:<ruby><rb>重</rb><rt>chóng</rt></ruby>,不是<ruby>重<rt>chóng</rt></ruby> - 多音并列标注(如「重庆」的「重」字需同时标两个音),必须用多个
<rb></rb>+<rt></rt>并排:<ruby><rb>重</rb><rt>chóng</rt><rb>重</rb><rt>zhòng</rt></ruby> - Vue/React 中注意:
<rb></rb>和<rt></rt>必须是<ruby></ruby>的**直接子节点**,中间不能插<fragment></fragment>或条件渲染空格
声调与轻声必须用 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,否则可能返回数字格式
最易被忽略的一点:多音字标注不是“技术问题”,而是“语义决策问题”。你写的每一组 <rb><rt></rt></rb>,都在告诉浏览器和读屏器“这个词在这里就读这个音”。一旦写错,修复成本远高于写对——因为要重新走无障碍测试、SEO 重爬、用户反馈闭环。所以别图快,先查《现代汉语词典》或权威语料库,再落笔。



















