HTMLAnchorElement

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

HTMLAnchorElement 接口代表超链接元素,并提供 (除了它们继承自常规 HTMLElement 对象接口的特殊属性和方法之外) 用于操作此类元素的布局和表示的特殊属性和方法。此接口对应于 <a> 元素;不要与 <link> 混淆,后者由 HTMLLinkElement 表示。

EventTarget Node Element HTMLElement HTMLAnchorElement

实例属性

继承自其父级 HTMLElement 的属性。

HTMLAnchorElement.attributionSrc 安全上下文 实验性

以编程方式获取和设置 <a> 元素上的 attributionsrc 属性,反映该属性的值。attributionsrc 指定您希望浏览器发送 Attribution-Reporting-Eligible 标头。在服务器端,这用于触发在响应中发送 Attribution-Reporting-Register-Source 标头,以注册基于导航的归因源。

HTMLAnchorElement.download

一个字符串,指示链接的资源旨在下载而不是在浏览器中显示。该值表示文件的建议名称。如果名称不是底层操作系统有效的文件名,浏览器将对其进行调整。

HTMLAnchorElement.hash

一个字符串,表示引用的 URL 中的片段标识符,包括前面的井号 (#),如果有的话。

HTMLAnchorElement.host

一个字符串,表示引用的 URL 中的主机名和端口 (如果不是默认端口)。

HTMLAnchorElement.hostname

一个字符串,表示引用的 URL 中的主机名。

HTMLAnchorElement.href

一个字符串,它是相对于文档解析 href HTML 属性的结果,包含链接资源的有效 URL。

HTMLAnchorElement.hreflang

一个字符串,反映 hreflang HTML 属性,指示链接资源的语言。

HTMLAnchorElement.origin 只读

返回一个包含 URL 来源的字符串,即其协议、域名和端口。

HTMLAnchorElement.password

一个字符串,包含在域名之前指定的密码。

HTMLAnchorElement.pathname

一个字符串,包含一个初始的 /,后跟 URL 的路径,不包括查询字符串或片段。

HTMLAnchorElement.ping

一个以空格分隔的 URL 列表。当链接被点击时,浏览器将向这些 URL 发送带有 PING 正文的 POST 请求。

HTMLAnchorElement.port

一个字符串,表示引用的 URL 中的端口组件 (如果有)。

HTMLAnchorElement.protocol

一个字符串,表示引用的 URL 中的协议组件,包括尾随的冒号 (:)。

HTMLAnchorElement.referrerPolicy

一个字符串,反映 referrerpolicy HTML 属性,指示要使用的引用者。

HTMLAnchorElement.rel

一个字符串,反映 rel HTML 属性,指定目标对象与链接对象的关系。

HTMLAnchorElement.relList 只读

返回一个 DOMTokenList,反映 rel HTML 属性,作为令牌列表。

HTMLAnchorElement.search

一个字符串,表示引用的 URL 中的搜索元素,包括前面的问号 (?),如果有的话。

HTMLAnchorElement.target

一个字符串,反映 target HTML 属性,指示链接资源的显示位置。

HTMLAnchorElement.text

一个字符串,是 Node.textContent 属性的同义词。

HTMLAnchorElement.type

一个字符串,反映 type HTML 属性,指示链接资源的 MIME 类型。

HTMLAnchorElement.username

一个字符串,包含在域名之前指定的用户名。

已废弃的属性

HTMLAnchorElement.charset 已弃用

一个字符串,表示链接资源的字符编码。

HTMLAnchorElement.coords 已弃用

一个字符串,表示逗号分隔的坐标列表。

HTMLAnchorElement.name 已弃用

一个字符串,表示锚点名称。

HTMLAnchorElement.rev 已弃用

一个字符串,表示 rev HTML 属性,指定链接对象与目标对象的关系。

HTMLAnchorElement.shape 已弃用

一个字符串,表示活动区域的形状。

实例方法

继承自其父级 HTMLElement 的方法。

HTMLAnchorElement.toString()

返回一个包含整个 URL 的字符串。它是 HTMLAnchorElement.href 的同义词,尽管它不能用于修改该值。

规范

规范
HTML
# htmlanchorelement

浏览器兼容性

另见

  • 实现此接口的 HTML 元素:<a>