+省略即可生效,兼容现代浏览器;优于aria-label和JS方案,因其原生语义、复制保留基字、语音朗读准确、支持变调拼音标注。

直接用 <ruby></ruby> + <rt></rt>,不加 <rb></rb> 也能生效,浏览器兼容性足够日常使用。
为什么不用 aria-label 或 JS 模拟读音?
语音朗读(如屏幕阅读器)对 aria-label 的处理不统一:部分会覆盖原文字,部分忽略拼音;JS 注入拼音则破坏语义、增加维护成本、且无法被搜索引擎或复制文本正确识别。而 <ruby></ruby> 是 HTML 原生语义标签,专为注音设计,复制时默认只保留基字(<ruby></ruby> 内容不被选中),打印/导出也保持清晰结构。
<ruby></ruby> 最简写法与常见错误
标准写法本应包含 <rb></rb>(基字)和 <rt></rt>(注音),但现代浏览器(Chrome 12+、Firefox 110+、Safari 17+)支持省略 <rb></rb>,直接把文本子节点当基字处理——这意味着你只需写一行:
<ruby>长<rt>zhǎng</rt></ruby>
常见错误包括:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- 误用
<rp></rp>包裹括号:除非需兼容极老 IE(已无必要),否则<rp></rp>完全可省略 - 把多音字整个包进
<ruby></ruby>却漏掉部分字:例如「重拾」应分别标注<ruby>重<rt>chóng</rt></ruby><ruby>拾<rt>shí</rt></ruby></li> <li>在 <code><rt>
里写汉字(如「长(掌)」):这会干扰语音合成,应只用标准汉语拼音
遇到「一」「不」等变调字怎么处理?
按实际口语读音标注即可,无需还原本调。例如:
- 「一个」读作 yí gè → 标注
<ruby>一<rt>yí</rt></ruby> - 「不去」读作 bú qù → 标注
<ruby>不<rt>bú</rt></ruby>
注意:拼音必须带声调符号(ā á ǎ à),不能写成 ya 或 ya1,否则语音引擎无法正确发音。
真正容易被忽略的是上下文依赖的多音判断——比如「行」在「银行」里读 háng,但在「行走」里是 xíng,HTML 本身不提供语义推理能力,得靠人工逐处确认。自动标注工具常在这里出错,所以最简方案的前提,其实是你愿意花两秒看一眼词典。


















