应使用 标签标记键盘快捷键,如 ctrl+c,不可合并为 ctrl+c;它语义明确、支持无障碍访问,优于 或 。

HTML 里怎么标键盘快捷键(比如 Ctrl+C)
用 <kbd></kbd> 标签,不是 <code>,也不是 <span></span> 加 class。它专为用户按下的物理按键或组合键设计,语义清晰,屏幕阅读器也能正确朗读为“keyboard input”。
-
<kbd>Ctrl</kbd>+<kbd>C</kbd>渲染效果是:Ctrl+C(浏览器默认加粗+等宽+浅灰背景) - 组合键要拆开写,不要塞进一个
<kbd></kbd>里——<kbd>Ctrl+C</kbd>是错的,会丢失语义和可访问性 - 大小写敏感:写
<kbd>Shift</kbd>而不是<kbd>shift</kbd>,系统级快捷键习惯大写首字母 - Mac 用户看到
<kbd>Cmd</kbd>比<kbd>Ctrl</kbd>更自然,但别用<kbd>⌘</kbd>符号——它不是标准字符,复制粘贴易出错,也难被辅助工具识别
为什么不用 <code> 或 <span></span>
<code> 表示计算机代码片段,比如函数名、命令行输入;<span></span> 是无语义容器。两者都不能告诉浏览器“这是用户要按的键”,AT(辅助技术)会忽略或误读。
- 用
<code>Ctrl+C:屏幕阅读器可能读成 “C T R plus C”,而不是“Control-C” - 用
<span class="key">Ctrl</span>:完全没语义,CSS 再好看也没法被无障碍 API 捕获 -
<kbd></kbd>是 HTML Living Standard 明确定义的交互语义标签,兼容所有现代浏览器和主流读屏软件(NVDA、VoiceOver、JAWS)
<kbd></kbd> 在真实文档里的典型用法
常见于帮助文档、设置说明、CLI 工具网页版提示。重点是「用户动作」而非「系统反馈」——比如“按
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
<kbd>Esc</kbd> 关闭弹窗”,不是“程序返回 <code><kbd>ESC</kbd> 字符”。 <ul><li>嵌套合法:<code><kbd><kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd></kbd></code> </li></ul></code>(外层
<kbd></kbd> 表示整个组合操作)
<p>在终端中输入 <code>git commit 后,按 Ctrl+D 退出编辑器。
<kbd></kbd>,那是导航路径,不是按键容易被忽略的细节和兼容性问题
多数人写了 <kbd></kbd> 就以为完事了,但实际部署时有两个隐形坑:
- CSS 重置可能干掉默认样式:某些 UI 框架(如 Bootstrap)或全局
kbd { font-family: inherit; background: none; }会让<kbd></kbd>看起来和普通文字一样——务必检查渲染效果,必要时手动补kbd { font-family: ui-monospace, monospace; padding: 2px 4px; border-radius: 3px; background-color: #f0f0f0; } - 移动端没有物理键盘,但
<kbd></kbd>仍需保留:iOS/Android 的屏幕阅读器(VoiceOver/TalkBack)依然能正确解析并朗读,对视障用户操作触控界面有帮助
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










