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

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










