“重”读chóng时表示重复、再次,如重复、重阳;读zhòng时表示重要、重量等,如重要、重量。

多音字必须人工判断上下文,不能靠自动拼接
浏览器和ruby标签本身不识别语义,也不会根据前后字自动选读音。“重”在“重要”里读zhòng,在“重复”里读chóng——这个判断必须由你完成,不是交给 HTML 或 CSS 去猜。
常见错误是写成重,这会让屏幕阅读器朗读两个音、语音合成器卡顿,也违反“一对一映射”规范。
- 每个
只能配一个,且顺序严格对应 - 上下文决定读音:查《现代汉语词典》或权威分词库(如 jieba + 自定义词典)辅助判断
- 若同一页面多次出现同一多音字但读音不同,需分别标注,不可复用同一段 HTML
正确结构:逐字拆开 + rb 显式包裹 + rt 精确绑定
哪怕单字,也要用明确基文锚点。Safari 和旧版 Edge 在没时会丢失对齐基准,拼音飘移、错位、甚至被忽略。
比如“长”在“长度”和“成长”中读音不同,应这样写:
<ruby><rb>长</rb><rt>cháng</rt></ruby>度 <ruby><rb>长</rb><rt>zhǎng</rt></ruby>成
注意:不能省略,不能跨字,也不能把两个字塞进一个再配一个(如长短),否则语义断裂,读屏软件无法准确关联。
动态生成时怎么避免拼音和汉字数量不一致
用pypinyin或类似工具时,别直接对字符串调lazy_pinyin()后硬塞进模板。中文里夹着 emoji、全角标点、组合字符(如「ā」)时,字符数和拼音数组长度可能不等。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 先用正则提取纯汉字块:
re.findall(r'[\u4e00-\u9fff]+', text) - 对每块逐字符调
lazy_pinyin(char, errors='ignore'),确保一一对应 - 非汉字部分(数字、英文、标点)原样保留,不套
- 禁用
errors='ignore'以外的选项,否则遇到生僻字会跳过,导致和数量错位
CSS 微调要守住底线:ruby-align 必须显式声明
ruby-align: center不是默认生效的,尤其在 Safari 16 及更早版本里它会退化为start,拼音贴左、视觉失衡。iOS Safari 17.4 在contenteditable里还要求加transform: translateZ(0)触发 GPU 渲染才能稳定对齐。
最小安全样式集:
ruby { ruby-align: center; -webkit-ruby-align: center; }
ruby > rb { display: inline-block; }
ruby > rt { font-size: 0.6em; line-height: 1; }
别给设width或margin,它没有传统盒模型;也别用position: absolute强行定位——可访问性、换行、缩放全崩。
最常被忽略的是:多音字一旦标错,用户听到的就是错音,而这个错误在源码里极难被 QA 发现,得靠人工逐句核对上下文。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










