标签专用于标记文档或文章作者的联系信息,如邮箱、网址等,不可用于贡献者列表;应仅出现在或内,内容须纯为联系信息,且通常只出现一次。

<address></address> 标签在 HTML5 中**专用于标记与当前文档或文章作者相关联的联系信息**,比如邮箱、网址、社交账号、物理地址等。它**不适用于标记任意“贡献者列表”或“团队成员”**,尤其不能用来包裹开源项目中多位贡献者的完整信息(如姓名、头像、GitHub 链接、提交次数等)。
address 标签的正确用途
它表示的是“本页内容的作者/编辑的联系信息”,语义上属于元信息层级,而非内容主体。浏览器和辅助技术会据此识别作者归属,SEO 也可能轻微参考。
- 只能出现在
<article></article>或级别(作为直接子元素或嵌套在<footer></footer>中) - 通常只出现一次,且应紧邻其所属内容(如文章末尾)
- 内容应为纯联系信息,不包含头衔、角色说明、头像、统计数字等
错误用法示例(不推荐)
以下写法违背语义,混淆了“作者联系信息”与“项目贡献者列表”的区别:
张三(核心维护者)
李四(文档贡献者)
王五(提交 42 次)
开源项目贡献者信息的合理 HTML 结构
应使用语义清晰、可扩展的结构,例如:
立即学习“前端免费学习笔记(深入)”;
- 用
<section></section>或<div role="region" aria-label="Contributors"> 包裹整个贡献者区块 <li>每位贡献者用 <code><article></article>或<figure></figure>表示独立个体(若需强调个人身份) - 用
<ul></ul>+<li>列出简洁贡献者链接(最常用、轻量、无障碍友好) - 关键联系信息(如项目主维护者邮箱或社区入口)可单独放在页面底部,并用
<address></address>标记
示例片段:
项目贡献者
小结:什么时候该用 address?
仅当你要声明“谁对当前网页/这篇文章负主要责任”**,并提供其可联系的方式时才用。
开源项目的贡献者列表是内容的一部分,不是作者元数据——把它放进 <address></address> 会让屏幕阅读器误读、搜索引擎误解、未来维护者困惑。



















