HTMLAnchorElement - 表示超链接元素

HTMLAnchorElement 接口表示超链接元素,并提供一些特殊的属性和方法(除了它继承的常规 HTMLElement 对象接口的属性和方法之外)来操纵这些元素的布局和表示。

属性

从其父类 HTMLElement 继承了属性,并实现了 HTMLHyperlinkElementUtils 中的属性。

HTMLAnchorElement.accessKey

一个 DOMString,表示将输入焦点切换到超链接的单个字符。

HTMLAnchorElement.download

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

HTMLHyperlinkElementUtils.hash

一个 USVString,表示片段标识符,包含引用的 URL 中的前导哈希标记('#')(如果有的话)。

HTMLHyperlinkElementUtils.host

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

HTMLHyperlinkElementUtils.hostname

一个 USVString,表示引用的 URL 中的主机名。

HTMLHyperlinkElementUtils.href

一个 USVString,它反映了 href HTML 属性,包含链接资源的有效 URL。

HTMLAnchorElement.hreflang

一个 DOMString,它反映了 hreflang HTML 属性,表示链接资源的语言。

HTMLAnchorElement.media

一个 DOMString,它反映了 media HTML 属性,表示链接资源的预期媒体。

HTMLHyperlinkElementUtils.password

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

HTMLHyperlinkElementUtils.origin 只读

一个 USVString,包含 URL 的源,即其 scheme,域和端口。

HTMLHyperlinkElementUtils.pathname

一个 USVString,表示引用的 URL 的路径组件(如果有的话)。

HTMLHyperlinkElementUtils.port

一个 USVString,表示引用 URL 的端口组件(如果有的话)。

HTMLHyperlinkElementUtils.protocol

一个 USVString,表示引用 URL 的协议组件,包括尾部冒号(':')。

HTMLAnchorElement.referrerPolicy

一个 DOMString,它反映了 referrerpolicy HTML 属性,指示要使用的引用策略。

HTMLAnchorElement.rel

一个 DOMString,它反映了 rel HTML 属性,指定了目标对象与链接对象的关系。

HTMLAnchorElement.relList 只读

返回一个 DOMTokenList,是一个标记列表,反映了 rel HTML 属性。

HTMLHyperlinkElementUtils.search

一个 USVString 表示搜索元素,包括引用 URL 的前导问号('?')(如果有的话)。

HTMLAnchorElement.tabindex

一个 long,包含当前文档的 Tab 键导航顺序中该元素的位置。

HTMLAnchorElement.target

一个 DOMString,它反映了 target HTML 属性,指示了显示链接资源的位置。

HTMLAnchorElement.text

一个 DOMString,是 Node.textContent 属性的同义词。

HTMLAnchorElement.type

一个 DOMString,它反映了 type HTML 属性,表示链接资源的 MIME 类型。

HTMLHyperlinkElementUtils.username

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

过时的属性

HTMLAnchorElement.charset

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

HTMLAnchorElement.coords

一个 DOMString,表示以逗号分隔的坐标列表。

HTMLAnchorElement.name

一个 DOMString 表示锚名称。

HTMLAnchorElement.rev

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

注意:目前 W3C HTML 5.2 规范声明 rev 不再过时,而 WHATWG 现行标准仍然标记为过时。在解决这种差异之前,您仍应认为它已过时。

HTMLAnchorElement.shape

一个 DOMString 表示活动区域的形状。

方法

从其父类 HTMLElement 继承了方法,并实现了 HTMLHyperlinkElementUtils 中的方法。

HTMLElement.blur()

从当前元素中删除键盘焦点。

HTMLElement.focus()

将键盘焦点赋予当前元素。

HTMLHyperlinkElementUtils.toString()

返回一个 USVString,包含整个 URL。它是URLUtils.href 的同义词,但它不能用于修改值。

blur()focus() 方法从 HTML5 开始继承自 HTMLElement,但是在 DOM Level 2 HTML 和早期规范中是在 HTMLAnchorElement 上定义。

规范

规范 状态 备注
HTML Living Standard
HTMLAnchorElement 的定义
现行的标准 添加了以下属性:download。从技术上讲,与 URL 相关的属性, mediahosthostnamepathnameportprotocolsearchhash 已被移到 URLUtils 接口,同时 HTMLAnchorElement 实现了这个接口。
HTML5
HTMLAnchorElement 的定义
推荐 现在改为在 HTMLElement 上定义 blur()focus() 方法,以及 tabindexaccessKey 属性。
以下属性现已过时:charsetcoordsnamerevshape
添加了以下属性:hashhosthostnamemediapathnameportprotocolrelListsearchtext
Document Object Model (DOM) Level 2 HTML Specification
HTMLAnchorElement 的定义
已过时 Document Object Model (DOM) Level 1 Specification 相比没有变化。
Document Object Model (DOM) Level 1 Specification
HTMLAnchorElement 的定义
已过时 初始定义。

桌面浏览器兼容性

特性 Chrome Edge Firefox Internet Explorer Opera Safari
基础支持 支持 支持 1 支持 支持 支持
accessKey 支持 支持 1 支持 支持 支持
download 14 13 20 未知 15 未知
hreflang 支持 12 1 支持 支持 支持
media 支持 支持 1 支持 支持 支持
referrerPolicy 51 支持 50 不支持 不支持 不支持
rel 支持 12 1 支持 支持 支持
relList 支持 支持 1 支持 支持 支持
tabindex 支持 支持 1 支持 支持 支持
target 支持 12 1 支持 支持 支持
text 支持 12 1 支持 支持 支持
type 支持 12 1 支持 支持 支持
charset 支持 12 1 支持 支持 支持
coords 支持 12 1 支持 支持 支持
name 支持 12 1 支持 支持 支持
rev 支持 12 1 支持 支持 支持
shape 支持 12 1 支持 支持 支持

移动浏览器兼容性

特性 Android Chrome for Android Edge mobile Firefox for Android IE mobile Opera Android iOS Safari
基础支持 支持 支持 支持 4 未知 支持 支持
accessKey 支持 支持 支持 4 未知 支持 支持
download 14 14 支持 未知 未知 未知 未知
hreflang 支持 支持 支持 4 未知 支持 支持
media 支持 支持 支持 4 未知 支持 支持
referrerPolicy 51 51 未知 50 未知 支持 不支持
rel 支持 支持 支持 4 未知 支持 支持
relList 支持 支持 支持 4 未知 支持 支持
tabindex 支持 支持 支持 4 未知 支持 支持
target 支持 支持 支持 4 未知 支持 支持
text 支持 支持 支持 4 未知 支持 支持
type 支持 支持 支持 4 未知 支持 支持
charset 支持 支持 支持 4 未知 支持 支持
coords 支持 支持 支持 4 未知 支持 支持
name 支持 支持 支持 4 未知 支持 支持
rev 支持 支持 支持 4 未知 支持 支持
shape 支持 支持 支持 4 未知 支持 支持

相关链接

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