<a>:锚元素
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
* Some parts of this feature may have varying levels of support.
HTML <a> 元素(或称锚元素)可以通过它的 href 属性创建通向其他网页、文件、电子邮件地址、同一页面内的位置或任何其他 URL 的超链接。
<a> 中的内容应该指明链接的目标。如果存在 href 属性,当 <a> 元素聚焦时按下回车键就会激活它。
尝试一下
<p>你可以通过这些联系方式找到小明:</p>
<ul>
<li><a href="https://example.com">网站</a></li>
<li><a href="mailto:m.bluth@example.com">电子邮件</a></li>
<li><a href="tel:+123456789">电话</a></li>
</ul>
li {
margin-bottom: 0.5rem;
}
属性
该元素的属性包含全局属性。
attributionsrc已弃用-
要求浏览器发送
Attribution-Reporting-Eligible标头。在服务器端,此操作将触发响应中发送Attribution-Reporting-Register-Source标头,用于注册基于导航的归因来源。当用户点击链接时,浏览器会存储与基于导航的归因来源相关的源数据(该数据由
Attribution-Reporting-Register-Source响应标头提供)。更多详情请参阅归因报告 API。此属性有两种可设置的版本:
-
布尔值,即仅使用
attributionsrc名称。这表示希望将Attribution-Reporting-Eligible标头发送至与href属性指向的相同服务器。当在同一服务器上处理归因来源注册时,此方式即可满足需求。 -
包含一个或多个 URL 的值,例如:
htmlattributionsrc="https://a.example/register-source https://b.example/register-source"当请求的资源不在你控制的服务器上,或者希望在其他服务器上处理归因来源的注册时,此功能非常有用。此时,可以将一个或多个 URL 作为
attributionsrc的值进行指定。当资源请求发生时,系统将向资源源地址及attributionsrc中指定的 URL 发送Attribution-Reporting-Eligible标头。这些 URL 可返回Attribution-Reporting-Register-Source标头以完成注册流程。备注:指定多个 URL 意味着可在同一功能上注册多个归因来源。例如,可能需要评估不同营销活动的成效,这涉及基于不同数据生成各类报告。
<a>元素不可用作归因触发器,仅可作为来源使用。 -
download-
导致浏览器将链接的 URL 视为下载资源。可以使用或不使用
filename值:-
如果没有指定值,浏览器会从多个来源决定文件名和扩展名:
Content-DispositionHTTP 标头。- URL 路径的最后一段。
- 媒体类型(来自
Content-Type标头、data:URL 的开头,或blob:URL 的Blob.type)。
-
filename:决定文件名的值。/和\被转化为下划线(_)。文件系统可能会阻止文件名中其他的字符,因此浏览器会在必要时适当调整文件名。
备注:
download只在同源 URL 或blob:、data:协议起作用。- 浏览器对待下载的方式因浏览器、用户设置和其他因素而异。在下载开始之前,可能会提示用户,或者自动保存文件,或者自动打开。自动打开要么在外部应用程序中,要么在浏览器本身中。
- 如果
Content-Disposition标头的信息与download属性不同,产生的行为可能不同:- 如果标头指定了
filename,它将优先于download属性中指定的文件名。 - 如果标头指定了
inline的处置方式,Chrome 和 Firefox 会优先考虑该属性并将其视为下载资源。旧的 Firefox 浏览器(版本 82 之前)优先考虑该标头,并将内联显示内容。
- 如果标头指定了
-
href-
超链接所指向的 URL。链接不限于基于 HTTP 的 URL——它们可以使用浏览器支持的任何 URL 协议:
- 带
tel:URL 的电话号码 - 带
mailto:URL 的电子邮件地址 - 带
sms:URL 的短信 - 带
javascript:URL 的可执行代码 - 如果 web 浏览器不支持其他 URL 方案,网站可以使用
registerProtocolHandler()
此外,URL 的其他特性可定位资源的特定部分,包括:
- 使用文档片段链接到页面的某一段
- 使用文本片段链接到某一段文字
- 使用媒体片段链接到某个媒体文件
- 带
hreflang-
该属性用于指定所链接到的文档的人类语言。其仅提供建议,并没有内置的功能。其允许的值与全局的
lang属性一致。 interestfor实验性 非标准-
将
<a>元素定义为关注触发器。其值为目标元素的id,当触发器元素获得或失去关注时(例如通过悬停/取消悬停或聚焦/取消聚焦),该目标元素将受到某种影响(通常表现为显示或隐藏)。更多细节和示例请参阅使用关注触发器。 ping-
包含一个以空格分隔的 URL 列表,当跟随超链接时,浏览器会发送带有正文
PING的POST请求。通常用于跟踪。 referrerpolicy-
在跟随链接时,referrer 需要发送多少内容:
no-referrer:不会发送Referer标头。no-referrer-when-downgrade:Referer标头将不会发送到未启用 TLS(HTTPS)的源上。origin:发送的 referrer 将被限制在其页面的源:方案、主机和端口。origin-when-cross-origin:发送到其他源的 referrer 将只包含协议、主机和端口,而导航到相同的源仍将包括路径。same-origin:将向同源地址发送 referrer,但跨源请求不包含 referrer 信息。strict-origin:当协议安全级别保持不变(HTTPS→HTTPS)时,只将文档的来源作为 referrer 发送,但不要将其发送到安全性较低的目的地(HTTPS→HTTP)。strict-origin-when-cross-origin(默认):在执行同源请求时发送完整的 URL,在协议安全级别保持不变时只发送源(HTTPS→HTTPS),对安全性较低的目的地不发送标头(HTTPS→HTTP)。unsafe-url:表示 referrer 将会包含源和路径(但是不包含片段、密码或用户名)。此值是不安全的,因为它可能会将受 TLS 保护的资源的源和路径泄露到不安全的源中。
rel-
该属性指定了目标对象到链接对象的关系。
target-
该属性指定在何处显示链接的 URL,作为浏览上下文的名称(标签、窗口或
<iframe>)。以下关键词对加载 URL 的位置有特殊含义:-
_self:当前浏览上下文。(默认) -
_blank:通常在新标签页打开,但用户可以通过配置选择在新窗口打开。 -
_parent:当前浏览环境的父级浏览上下文。如果没有父级框架,行为与_self相同。 -
_top:最顶级的浏览上下文(当前浏览上下文中最“高”的祖先)。如果没有祖先,行为与_self相同。 -
_unfencedTop:允许嵌入式围栏框架导航至顶级框架(即在围栏框架根节点上层进行遍历,不同于其他保留目标)。请注意,若在围栏框架上下文之外使用此功能,导航仍将成功,但不会像保留关键字那样起作用。备注:在
<a>元素上使用target="_blank"隐式提供了与使用rel="noopener"相同的rel行为,即不会设置window.opener。
-
type-
该属性指定在一个 MIME 类型链接目标的形式的媒体类型。没有内置的功能。
已弃用属性
charset已弃用-
此属性定义链接资源的字符编码。
备注:该属性已弃用,不应由作者使用。请在链接的 URL 上使用 HTTP
Content-Type标头。 coords已弃用-
与
shape属性一同使用,以逗号分隔的坐标列表。 name已弃用-
在定义一个可能的目标位置时曾经是必需的。在 HTML 4.01 规范中,
<a>元素可以同时使用id和name,只要它们有相同的值。备注:使用全局属性
id来代替。 rev已弃用-
指定一个反向链接;与
rel属性作用相反。因为非常混乱而弃用。 shape已弃用-
图像映射(image map)中超链接区域的形状。
备注:使用
<area>元素来代替图像映射。
无障碍
>强调链接文本
链接内的内容应表明链接的去向,即使脱离了上下文。
无障碍性差的链接文本
一个通常的错误在于只链接了“点击这里”或“这里”词语:
<p><a href="/products">在这里</a>了解到有关产品的更多信息。</p>
结果
无障碍性良好的链接文本
幸运的是,这是一个很容易解决的问题,而且实际上比无障碍性差的版本要短一些!
<p>了解<a href="/products">有关产品</a>的更多信息。</p>
结果
辅助软件有快捷键来列出页面上的所有链接。然而,无障碍性强的链接文本对所有用户都有好处。“列出所有链接”的快捷方式模仿了视力正常的用户快速扫描页面的方式。
onclick 事件
锚点元素常被滥用为伪按钮:通过将 href 属性设置为 # 或 javascript:void(0) 来防止页面刷新,随后监听其 click 事件。
这些虚假的 href 值在复制/拖动链接、在新的标签/窗口中打开链接、书签,或当 JavaScript 正在加载、出错或被禁用时,会导致意外行为。它们还向辅助技术(如屏幕阅读器)传达不正确的语义。
请使用 <button> 代替。一般来说,你应该只使用超链接来导航到一个真正的 URL。
外部链接与链接至非 HTML 资源
通过 target="_blank" 在新标签/窗口中打开的链接,或指向下载文件的链接,应说明在跟踪链接时将发生什么。
当一个新的标签、窗口或应用程序意外打开时,有低视力状况的人、借助屏幕阅读技术导航的人或有认知障碍的人可能会感到困惑。老式的读屏软件甚至可能不会宣告这种行为。
打开新标签页/新窗口的链接
<a target="_blank" href="https://www.wikipedia.org">
Wikipedia(将在新标签页中打开)
</a>
结果
链接至非 HTML 资源
若使用图标表示链接行为,请确保其带有 alt 属性以描述其用途。即使图标缺失,alt 属性的内容仍能传达链接的行为。
<p>
<a href="https://www.wikipedia.org/" target="_blank">
维基百科
<img src="new-tab.svg" width="14" alt="(在新标签页中打开)" />
</a>
<br />
<a href="2017-annual-report.ppt">
2017 年度报告
<img src="powerpoint.svg" width="14" alt="(PowerPoint 文件)" />
</a>
</p>
<p>
<a href="https://www.wikipedia.org/" target="_blank">
维基百科
<img src="missing-icon.svg" width="14" alt="(在新标签页中打开)" />
</a>
<br />
<a href="2017-annual-report.ppt">
2017 年度报告
<img src="missing-icon.svg" width="14" alt="(PowerPoint 文件)" />
</a>
</p>
结果
跳转链接
跳转链接(skip link)是在 <body> 内容中尽可能早地放置一个链接,指向页面主要内容的开头。通常情况下,CSS 会将跳转链接隐藏在屏幕之外,直到被聚焦。
<body>
<a href="#content" class="skip-link">跳转至主要内容</a>
<header>…</header>
<!-- 跳转链接会跳转至这里 -->
<main id="content"></main>
</body>
.skip-link {
position: absolute;
top: -3em;
background: #fff;
}
.skip-link:focus {
top: 0;
}
结果
跳转链接让键盘用户绕过多个页面中重复的内容,如标题导航。
跳过链接对依赖辅助技术(如开关控制、语音指令或口控笔/头控笔)进行导航的人群尤为实用,因为在这些设备操作中,逐个点击重复链接的过程往往十分费力。
尺寸和距离
尺寸
交互式元素,如链接,应提供足够大的区域,以便于激活它们。这有助于各种人,包括那些有运动控制问题的人和那些使用不精确输入的人,如触摸屏。建议最小尺寸为 44×44 CSS 像素。
散文内容中的纯文本链接不受这一要求影响,但确保有足够的文本超链接,以便于激活,仍然是一个好主意。
距离
交互式元素,如链接,放置在视觉上很近的地方,应该有空间将它们分开。间隔有助于有运动控制问题的人,否则他们可能会意外地激活错误的互动内容。
间隔可以使用 CSS 属性来创建,如 margin。
示例
>链接至绝对 URL
HTML
<a href="https://www.mozilla.com">Mozilla</a>
结果
链接至相对 URL
HTML
<a href="//example.com">相对于协议的 URL</a>
<a href="/zh-CN/docs/Web/HTML">相对于源的 URL</a>
<a href="p">相对于目录的 URL</a>
<a href="./p">相对于目录的 URL</a>
<a href="../p">相对于父目录的 URL</a>
结果
链接至同一页面的元素
<!-- <a> 元素链接到下面的某一章节 -->
<p><a href="#Section_further_down">跳转至下方标题</a></p>
<!-- 要链接到的标题 -->
<h2 id="Section_further_down">更下方的部分</h2>
结果
备注:可以使用 href="#top" 或空片段(href="#")链接到当前页面的顶部,具体定义详见 HTML 规范。
链接至邮箱地址
要创建在用户的电子邮件程序中打开的链接以便发送新邮件,请使用 mailto: 协议:
<a href="mailto:nowhere@mozilla.org">向某个地方发邮件</a>
结果
链接至电话号码
<a href="tel:+49.157.0156">+49 157 0156</a>
<a href="tel:+1(800)555-0123">(800) 555-0123</a>
结果
tel: 链接的行为因设备能力而异:
- 移动设备会自动拨打该号码。
- 大多数操作系统都包含可拨打电话的程序,如 Skype 或 FaceTime。
- 网站可通过
registerProtocolHandler实现电话呼叫功能,例如web.skype.com。 - 其他行为包括将号码保存至通讯录或发送至其他设备。
有关 tel: URL 方案的语法、附加功能及其他细节,请参阅 RFC 3966。
使用 download 属性将 <canvas> 保存为 PNG 文件
要将 <canvas> 元素的内容保存为图像,可创建一个链接:其 href 属性使用 JavaScript 生成的 data: URL 指向画布数据,而 download 属性则为下载的 PNG 文件指定文件名:
具有保存链接的画图应用
HTML
<p>
按住鼠标按钮并移动来绘画。
<a href="" download="my_painting.png">下载我的绘画作品</a>
</p>
<canvas width="300" height="300"></canvas>
CSS
html {
font-family: sans-serif;
}
canvas {
background: white;
border: 1px dashed;
}
a {
display: inline-block;
background: #6699cc;
color: white;
padding: 5px 10px;
}
JavaScript
const canvas = document.querySelector("canvas");
const c = canvas.getContext("2d");
c.fillStyle = "hotpink";
let isDrawing;
function draw(x, y) {
if (isDrawing) {
c.beginPath();
c.arc(x, y, 10, 0, Math.PI * 2);
c.closePath();
c.fill();
}
}
canvas.addEventListener("mousemove", (event) =>
draw(event.offsetX, event.offsetY),
);
canvas.addEventListener("mousedown", () => (isDrawing = true));
canvas.addEventListener("mouseup", () => (isDrawing = false));
document
.querySelector("a")
.addEventListener(
"click",
(event) => (event.target.href = canvas.toDataURL()),
);
结果
安全与隐私
<a> 元素可能对用户的隐私和安全造成影响。详情请参阅 Referer 标头:隐私与安全问题。
在未使用 rel="noreferrer" 和 rel="noopener" 的情况下使用 target="_blank" 使网站易受 window.opener API 漏洞攻击,但需注意:在新版浏览器中,设置 target="_blank" 默认提供与 rel="noopener" 相同的防护机制。详情请参阅浏览器兼容性。
技术概要
规范
| Specification |
|---|
| HTML> # the-a-element> |