多音字必须逐字独立标注,如“长”在“生长”中读zhǎng、“长度”中读cháng,须写为生shēng长zhǎng和长cháng度dù,禁用合并注音,否则导致屏幕阅读器误读、语义丢失与样式错位。

多音字必须拆开用 单独包裹每个字
HTML5 的 ruby 不支持“一容器多字+一注音”的写法,强行合并会导致屏幕阅读器朗读错误、语义丢失、CSS 样式错位。例如“长”在“生长”中读 zhǎng,在“长度”中读 cháng,不能写成 生长。
正确做法是逐字标注:
<ruby>生<rt>shēng</rt></ruby><ruby>长<rt>zhǎng</rt></ruby>
- 每个汉字必须紧邻自己的
,中间不能有空格或换行 - 连续多音字(如“好”“发”“行”)必须全部拆解,哪怕上下文明确也需保持一对一
- 避免用
包裹括号——现代浏览器已默认兼容,加了反而增加冗余解析负担
如何处理口语变调与轻声(比如“我们”“妈妈”)
拼音标注要反映实际读音,不是查字典式机械拼写。 里写 “wǒ men”,不是 “wǒ mén”;写 “mā ma”,不是 “mā mā”。否则语音合成引擎会按字正腔圆朗读,失去真实语感。
实操建议:
- 轻声不标声调数字(如 “ma” 而非 “mā”),但保留字母小写格式
- 儿化音写完整拼音,如“花儿”标为
花儿,不要合并成 “huār” —— 后者无法被多数读屏软件识别为独立音节 - 不依赖
data-pinyin等自定义属性替代:辅助技术只认标准,其他属性纯属前端备用,不可靠
小说段落里混排注音时,样式容易撑破行高
默认 ruby 注音会提升行高,尤其在密集排版的小说正文里,常导致上下行文字挤压、注音重叠。这不是 bug,而是规范行为——ruby 本就要求预留足够垂直空间保障可访问性。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
安全微调方式:
- 统一控制注音字号:
rt { font-size: 0.65em; },别用px,否则缩放失效 - 收紧行距但不牺牲可读性:
ruby { line-height: 1.7; },低于 1.6 易遮挡汉字 - 禁用
position: absolute或transform: translateY()强行压位置——这会让读屏器跳过注音,直接读汉字,等于废掉无障碍功能 - 如果某段注音特别密(如古籍对话体),可临时加 class:
,再单独设…
.ruby-tight rt { font-size: 0.6em; }
为什么不用 JS 动态注入拼音?
有人想用 JS 扫描文本自动加 ,看似省事,实际埋雷:
- 服务端未渲染时,纯文本无注音,SEO 和 RSS 订阅抓取不到拼音信息
- JS 失败(网络中断、CSP 阻断、用户禁用)则整段多音字彻底裸奔,读者无法判断读音
- 无法保证“字-音”严格一一对应——JS 分词逻辑很难 100% 准确识别语境(比如“乐”在“快乐”和“音乐”中不同),而人工标注可结合上下文精准选择
- 首次加载延迟:小说章节动辄几千字,JS 解析+插入 DOM 会造成明显卡顿,尤其低端设备
真正高效的方式,是在编辑阶段就用支持 ruby 的 Markdown 编辑器(如 Typora + 自定义 CSS)或写作工具预置模板,把标注动作前置到创作流里,而不是留到发布前靠脚本补救。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










