HTML中多音字必须人工依语境用字音标注,浏览器不自动识别古音;必需包裹汉字,只放拼音,需结合权威考据确保韵脚统一。

HTML 中用 <ruby></ruby> 标注多音字,不是靠 CSS 或 JS 猜读音
古诗里“斜”“衰”“骑”“解”这类字,xié/shé、shuāi/cuī、qí/jì、jiě/xiè/jiè 的读音必须按语境区分,浏览器不会自动判断。硬写 <span>斜</span> + CSS 上标拼音,既不语义化,也不方便屏幕阅读器识别。唯一合规、可访问、能被电子书/朗读工具正确解析的方式,是用 HTML5 原生的 <ruby></ruby> 结构。
标准写法是:
<p>远上寒山石径<ruby><rb>斜</rb><rt>xiá</rt></ruby></p>
注意三点:
立即学习“前端免费学习笔记(深入)”;
-
<rb></rb>(ruby base)必须包裹被注音的汉字,不能是空格或标点 -
<rt></rt>(ruby text)只放拼音,不带声调符号也行,但推荐用带声调的xiá,否则语音合成引擎可能读错 - 整组
<ruby></ruby>要嵌在正常段落流中,不要套<div> 或强行换行,否则破坏行内布局<h3>押韵字单独加 class 是为了后期控制朗读行为,不是为了显示</h3> <p>像《山行》中“斜”“家”“花”三个押韵字,光标拼音不够——你需要让 TTS(文本转语音)引擎知道:“这三个字要按古音连读,节奏拉长”。这时候得靠语义类名,而不是视觉样式。</p> <p>推荐这样写:</p><pre class="brush:php;toolbar:false;"><p>远上寒山石径<ruby><rb><span class="rhyme-a">斜</span></rb><rt>xiá</rt></ruby>,<br>白云生处有人<span class="rhyme-a">家</span>。</p><div class="aritcle_card flexRow"> <div class="artcardd flexRow"> <a class="aritcle_card_img" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image"><img src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="AgentGen — HTML to PDF & Image" ></a> <div class="aritcle_card_info flexColumn"> <a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image">AgentGen — HTML to PDF & Image</a> <p>将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……</p> </div> <a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div></pre><p>后续可通过 JS 检测 <code>document.querySelectorAll('.rhyme-a'),再调用 Web Speech API 的speechSynthesis.speak()时手动插入停顿或调整语速。纯静态 HTML 不会自动朗读,别指望加个 class 就能出声。常见误区:
- 用
title属性存拼音:鼠标悬停才显示,对无障碍和语音无效 - 把拼音塞进
aria-label:会覆盖原字朗读,导致“斜 xiá”被读成“xiá”,丢失汉字本体 - 给每个押韵字加不同 class(如
rhyme-1、rhyme-2):无实际用途,增加维护成本
批量处理古诗拼音时,别信“自动注音工具”的古音库
市面上多数 HTML 注音工具(比如“汇帮注音大师”导出的 HTML)默认走《普通话异读词审音表》,把“斜”固定为
xié,“衰”固定为shuāi。它们没有上下文语义分析能力,更不内置中古音系映射规则。如果你真要按古音标注,必须人工校验,依据是:
- 诗句位置(是否在韵脚)
- 所属诗体(五绝/七律/乐府等对押韵要求不同)
- 参考权威考订(如《全唐诗》校勘记、王力《汉语诗律学》)
例如刘禹锡《乌衣巷》“乌衣巷口夕阳
斜 ”,不能依赖工具输出,必须查证该字在此处属平声麻韵,与“花”“家”同辙,方取xiá。移动端 Safari 对
<ruby></ruby>渲染不一致,得加 fallbackiOS 16+ Safari 虽支持
<ruby></ruby>,但默认不显示<rt></rt>,需显式重置样式;Android Chrome 则可能把拼音挤到右侧而非正上方。最简 fallback 方案是:ruby { ruby-position: over; } rt { font-size: 0.6em; line-height: 1; } @media screen and (-webkit-min-device-pixel-ratio: 0) { /* iOS Safari 强制显示 rt */ ruby { -webkit-text-emphasis: none; } rt { display: inline; } }更稳妥的做法是:在
<ruby></ruby>外层包一层<span class="poem-ruby"></span>,CSS 里用::after伪元素兜底——当<rt></rt>不渲染时,至少把拼音作为文字附在汉字后,比如“斜(xiá)”。这比完全不显示强。复杂点在于:同一首诗里既有今音(如“停车坐爱枫林晚”的“坐”读
zuò),又有古音(“斜”读xiá),人工标注时容易漏掉非韵脚字的语境判断。最容易被忽略的,其实是“家”“花”这种看似没争议的字——它们在古音里也属麻韵开口呼,和“斜”同源,不是因为“斜”特殊才读xiá,而是整组韵脚必须统一归入发花辙。这点不理解,就容易把标注做成零散修补,失去音韵整体性。 - 用


















