必须逐字用包裹并配对应,因整词包裹会导致多音字无法分标、断行错位、语音朗读失序;标点不注音,拼音须用半角小写加Unicode声调,禁用绝对定位。

标题里的多音字必须拆开单字标注,不能整个 <h1></h1> 包一层 <ruby></ruby>,否则换行错位、语音朗读错乱、CSS 微调失效。
为什么 <h1></h1> 里直接套 <ruby></ruby> 会出问题
浏览器把 <ruby></ruby> 当作内联布局单元,而 <h1></h1> 是块级元素。强行让整个标题(比如 <h1>重庆银行</h1>)只包一个 <ruby></ruby>,会导致:
– “重庆”两字被当成一个基字,<rt></rt> 只能配一个拼音,无法体现“重”读 Chóng、“庆”读 qìng 的分字变音;
– 标题缩略或响应式断行时,“重”在第一行、“庆”在第二行,但拼音仍整体浮在第一行上方;
– 屏幕阅读器无法将 nǐ hǎo 拆解对应到“你”和“好”,只能当一串无结构文本朗读。
<h1></h1> 中每个汉字都要独立 <ruby></ruby> 包裹
正确做法是把标题文字逐字拆解,每个字单独用 <ruby></ruby> 包裹,并配对应的 <rt></rt>。例如“否极泰来”作为标题:
<h1><ruby>否<rt>pǐ</rt></ruby><ruby>极<rt>jí</rt></ruby><ruby>泰<rt>tài</rt></ruby><ruby>来<rt>lái</rt></ruby></h1>
- 多音字如“否”,必须按上下文选唯一读音,
<rt>pǐ</rt>而非<rt>fǒu/pǐ</rt>; - 轻声字(如“了”“的”)不标声调,写成
<rt>le</rt>或<rt>de</rt>; - 避免在
<ruby></ruby>外加空格或换行符,DOM 中保持紧凑,防止渲染间隙; - 若标题含标点(如《》、引号),标点不参与注音,也不用
<ruby></ruby>包裹。
CSS 让标题注音更醒目但不破坏语义
标题本身字号大,拼音默认尺寸容易看不清。微调只用安全属性:
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
立即学习“前端免费学习笔记(深入)”;
- 统一缩小拼音字号:
h1 ruby rt { font-size: 0.55em; }; - 加一点垂直余量防压字:
h1 ruby { line-height: 1.6; }; - 设颜色提升可读性:
h1 ruby rt { color: #d32f2f; }(避免纯黑,与正文区分); - 禁用拼音内换行:
h1 ruby rt { white-space: nowrap; }; - 绝对不要对
rt设position: absolute或top—— 这会让换行、缩放、朗读全崩。
动态生成标题注音时最容易漏的三件事
用 pinyin-pro 或后端 API 自动加注时,常见疏漏:
- 没过滤 HTML 实体(如
、<),导致<ruby></ruby>结构被截断; - 没处理全角空格或中文顿号、逗号,把它们也塞进
<ruby></ruby>里,造成无效嵌套; - 没校验拼音字符集:必须是半角小写字母 + Unicode 声调(如
āáǎà),不能混入数字调号(如zhang1)或全角字符。
最麻烦的其实是“词级读音”和“字级本音”的取舍——标题不是课文,通常优先标实际朗读音(如“重庆”标 Chóngqìng),但若用于教学场景,就得拆字标本音。这个判断没法自动化,得人工过一遍。


















