标签用于语义化定义缩写词,首次出现时必须带准确、完整、大小写一致的 title 属性(如 api),后续可直写;避免无 title、滥用或混用已废弃的 。

用 abbr 标签定义缩写词,核心是让技术文档既对人友好、也对机器(如屏幕阅读器、搜索引擎)清晰可读。它不靠视觉效果“吸引注意”,而是靠语义告诉系统:“这个词有全称,别当成普通文本处理”。
首次出现时必须包裹 + 准确填写 title
技术文档里像 API、DOM、JWT、TLS 这类术语,第一次出现就得用 abbr 包裹,并且 title 属性值必须是标准、完整、大小写一致的全称。例如:
-
<abbr title="Application Programming Interface">API</abbr>✅(不是 "a programming interface" 或空格/换行截断) -
<abbr title="JavaScript Object Notation">JSON</abbr>✅(不是 "JS object notation") - 错例:
<abbr>API</abbr>❌(没 title,语义失效)
避免重复解释,但保持上下文清晰
同一缩写在同一篇文档中,首次用 abbr 定义后,后续可直接写 “API”,无需再套标签。但要注意:
- 若文档较长或章节独立,可在新章节开头再次定义,增强可读性
- 不要为已成通用词的缩写滥用
abbr,比如 “URL”“HTTP” 在开发者文档中通常可不标;但面向新手的指南里仍建议标注 - 像 “JWT”(JSON Web Token)这种非一线通用词,即使多次出现,也建议始终用
abbr,因为读者可能随时跳读
配合基础 CSS 做轻量视觉提示
abbr 默认无样式,用户看不出哪里有解释。加一点 CSS 能快速提升识别度,又不破坏语义:
- 用
abbr[title]选择器统一加虚线下划线:abbr[title] { border-bottom: 1px dotted #666; cursor: help; } - 避免覆盖默认行为:不要设
text-decoration: none或移除下划线,否则视觉用户完全感知不到这是可交互元素 - 不依赖
title实现提示框——移动端不触发,键盘用户 tab 不到;真需要稳定提示,得用aria-describedby关联隐藏段落或 JS 实现
不和 acronym 混用,HTML5 只认 abbr
过去有人区分 acronym(首字母缩略词,如 NASA)和 abbr(截断缩写,如 Mr.),但HTML5 已废弃 acronym,所有情况统一用 abbr:
- 正确:
<abbr title="National Aeronautics and Space Administration">NASA</abbr> - 错误:
<acronym title="...">NASA</acronym>(Lighthouse 会报错,部分辅助工具忽略) - 日常缩写如 “Dr.”“vs.” 不需
abbr;已失去缩写感的词如 “laser”“scuba” 也不用
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











