HTMLLinkElement - 操作 <link> 元素的接口
HTMLLinkElement 接口表示外部资源的参考信息以及这些资源与文档的关系。该对象继承了 HTMLElement 接口的所有属性和方法。
属性
属性继承自父类 HTMLElement 和 LinkStyle。
HTMLLinkElement.as
一个 DOMString,表示 HTML 链接加载的内容的类型。
HTMLLinkElement.crossOrigin
一个 DOMString,表示该链接元素的 CORS 设置。有关详细信息,请参阅 CORS 设置属性。
HTMLLinkElement.disabled
一个 Boolean,表示链接是否被禁用;目前仅用于样式表链接。
HTMLLinkElement.href
一个 DOMString,表示目标资源的 URI。
HTMLLinkElement.hreflang
一个 DOMString,表示链接资源的语言代码。
HTMLLinkElement.media
一个 DOMString,表示资源适用的一种或多种媒体格式的列表。
HTMLLinkElement.referrerPolicy
一个 DOMString,表示 referrerpolicy HTML 属性,指示要使用哪个 referrer。
HTMLLinkElement.rel
一个 DOMString,表示从文档到资源的链接资源的前向关系。
HTMLLinkElement.relList 只读
一个 DOMTokenList,表示 HTML 属性 rel。
HTMLLinkElement.sizes 只读
一个 DOMSettableTokenList,表示 HTML 属性 sizes。
LinkStyle.sheet 只读
返回与给定元素关联的 StyleSheet 对象,如果没有,则返回 null。
HTMLLinkElement.type
一个 DOMString,表示链接资源的 MIME 类型。
过时的属性
HTMLLinkElement.charset
一个 DOMString,表示目标资源的字符编码。
HTMLLinkElement.rev
一个 DOMString,表示从资源到文档的链接资源的反向关系。
注意:目前,W3C HTML 5.2 规范指出,
rev不再过时,而 WHATWG 现行标准仍将其标记为过时。在解决这个差异之前,你应该仍然认为它已经过时了。
HTMLLinkElement.target
一个 DOMString,表示资源所应用的目标框架的名称。
方法
没有特有的方法; 所有方法继承自父类 HTMLElement 和 LinkStyle。
规范
| 规范 | 状态 | 备注 |
|---|---|---|
| Preload | 工作草案 | 定义了 <link rel="preload"> 和 as 属性。请注意,目前 Firefox 只支持预加载可缓存的资源。 |
| HTML Living Standard HTMLLinkElement 的定义 |
现行的标准 | 增加了以下属性:crossOrigin,referrerPolicy 和 as。 |
| HTML 5.1 HTMLLinkElement 的定义 |
推荐 | - |
| HTML5 HTMLLinkElement 的定义 |
推荐 | 移除了以下属性:charset,rev 和 shape。增加了以下属性:relList 和 sizes。 |
| Document Object Model (DOM) Level 2 HTML Specification HTMLLinkElement 的定义 |
已过时 | 增加了第二个继承,LinkStyle 接口。 |
| Document Object Model (DOM) Level 1 Specification HTMLLinkElement 的定义 |
已过时 | 初始定义。 |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 支持 | 支持 | 1.0 | 支持 | 支持 | 支持 |
sizes |
支持 | 不支持 | 不支持 | 未知 | 支持 | 未知 |
crossOrigin
|
支持 | 不支持 | 18 | 未知 | 支持 | 未知 |
referrerPolicy |
58 | 不支持 | 50 | 未知 | 45 | 未知 |
as |
50 | 未知 | 56 | 未知 | 37 | 支持 |
移动浏览器兼容性
| 特性 | Android Webview | Chrome for Android | Edge | Firefox Mobile | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 支持 | 支持 | 1.0 | 支持 | 支持 | 支持 |
sizes |
支持 | 支持 | 不支持 | 不支持 | 未知 | 支持 | 未知 |
crossOrigin
|
支持 | 支持 | 不支持 | 18.0 | 未知 | 支持 | 未知 |
referrerPolicy |
58 | 58 | 不支持 | 50.0 | 未知 | 45 | 未知 |
as |
50 | 50 | 未知 | 56.0 | 未知 | 37 | 未知 |
相关链接
- 实现该接口的 HTML 元素:
<link>.