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 相关的属性, media ,host ,hostname ,pathname ,port ,protocol ,search 和 hash 已被移到 URLUtils 接口,同时 HTMLAnchorElement 实现了这个接口。 |
HTML5 HTMLAnchorElement 的定义 |
推荐 | 现在改为在 HTMLElement 上定义 blur() 和 focus() 方法,以及 tabindex 和 accessKey 属性。以下属性现已过时: charset ,coords ,name ,rev 和 shape 。添加了以下属性: hash ,host ,hostname ,media ,pathname ,port ,protocol ,relList ,search 和 text 。 |
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>