多音字注音必须逐字独立包裹ruby标签,每个rt仅含对应单字拼音,禁用合并写法;pinyin-pro需启用multiple:true并结合语境筛选读音;CSS须设rt的font-size、white-space:nowrap及ruby的line-height,避免注音消失或错位。

多音字必须拆成单字 ruby 结构,不能合并写
浏览器不理解“上下文”,ruby 标签只做一对一映射。把“长”字塞进整句拼音里(比如 <ruby>长大<rt>zhǎng dà</rt></ruby>),会导致屏幕阅读器读错、CSS 对齐失效、甚至拼音叠在第二个字上。
正确做法是每个汉字独立包裹:<ruby>长<rt>zhǎng</rt></ruby><ruby>大<rt>dà</rt></ruby>。哪怕语义连贯,结构也必须断开。
- 多音字如“行”“重”“乐”,必须按实际读音逐字选
rt内容,不能留空或写“xíng/háng” - 若需保留备选读音,用
data-pinyin属性额外存一份,例如<ruby data-pinyin="xíng,háng">行<rt>xíng</rt></ruby> - 避免用
title或伪元素替代rt——那不算语义化注音,无障碍支持会降级
pinyin-pro 动态生成时怎么选对多音字?
自动标注最常踩的坑是默认取首音,而忽略语境。“银行”的“行”在大多数教育场景下应读 xíng,但库默认可能返回 yín háng。必须显式启用 multiple: true 并配合业务逻辑筛选。
示例代码中,不要直接用 pinyin('银行'),而是:
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
import { pinyin } from 'pinyin-pro';
const options = { multiple: true, toneType: 'symbol' };
const candidates = pinyin('银行', options); // ['yín háng', 'yín xíng']
// 根据词性/上下文选:教育类页面默认取第二个
const chosen = candidates[1] || candidates[0];
- 姓氏场景要加
mode: 'surname',否则“单于”会错标为dān yú - 不建议在前端硬编码所有多音字映射表——维护成本高,优先走
pinyin-pro的match+ 人工校验流程 - 生成 HTML 时,确保每个
rt只含一个字的拼音,且与前面汉字严格相邻,中间不能有空格或换行
CSS 样式里哪些设置会让多音字注音“突然消失”?
最常见的是没设 rt 的 font-size。浏览器默认把 rt 渲染成和汉字一样大,结果拼音撑满行高、被父容器 overflow: hidden 剪掉,或者压住下一行文字——看起来就像“没显示”。
关键 CSS 必须写全:
ruby { line-height: 2; }
ruby rt {
font-size: 0.6em;
color: #777;
white-space: nowrap;
}
- 漏掉
white-space: nowrap时,长拼音如“qiǎng cí duō nán”可能在空格处折行,导致对不齐 - 用
position: absolute覆盖原生布局?别碰。会破坏语音朗读顺序,也响应不了字体缩放 - 如果拼音被截断,先检查父元素是否设了
line-height: 1或overflow: hidden,而不是急着调rt的margin
要不要加 rp 标签?现代项目里基本可以跳过
rp 是为不支持 ruby 的老浏览器兜底的括号,比如 <rp>(</rp><rt>hàn</rt><rp>)</rp>。但现在 Chrome/Firefox/Safari/Edge 全部原生支持 ruby,且无障碍工具(NVDA、VoiceOver)也已适配标准结构。
加 rp 不仅冗余,还容易因样式冲突导致括号乱位。除非明确要兼容 IE11 或某些定制内核 WebView,否则直接省略。
- 真正影响体验的是
ruby和rt的语义完整性,不是括号有没有 - 如果用了
pinyin-pro生成 HTML,确认它输出的是干净的<ruby>字<rt>pīn</rt></ruby>,别带rp - 多音字场景下,更值得花时间校验的是拼音来源是否可靠,而不是纠结括号显示
zhòng,但在“重复”里读 chóng——这个判断得靠人,不是靠浏览器。


















