HTMLLinkElement

Baseline 广泛可用 *

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

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

HTMLLinkElement 接口表示外部资源的引用信息,以及这些资源与文档之间的关系(对应 <link> 元素;请勿与 <a> 混淆,后者由 HTMLAnchorElement 表示)。此对象继承了 HTMLElement 接口的所有属性和方法。

EventTarget Node Element HTMLElement HTMLLinkElement

实例属性

继承自其父级 HTMLElement 的属性。

HTMLLinkElement.as

一个字符串,表示当 rel="preload"rel="modulepreload" 时,HTML 链接正在加载的内容类型。

HTMLLinkElement.blocking

一个字符串,指示在获取外部资源时应阻止的某些操作。它反映了 <link> 元素的 blocking 属性。

HTMLLinkElement.crossOrigin

一个字符串,对应于此链接元素的 CORS 设置。有关详细信息,请参阅 CORS 设置属性

HTMLLinkElement.disabled

一个布尔值,表示链接是否被禁用;目前仅用于样式表链接。

HTMLLinkElement.fetchPriority

一个可选字符串,表示向浏览器提供的关于如何优先获取预加载资源相对于同类型其他资源的提示。如果提供了此值,它必须是允许的可能值之一:high 表示以更高优先级获取,low 表示以更低优先级获取,或 auto 表示不偏好(这是默认值)。

HTMLLinkElement.href

一个字符串,表示目标资源的 URI。

HTMLLinkElement.hreflang

一个字符串,表示链接资源的语言代码。

HTMLLinkElement.imageSizes

一个字符串,反映了 imagesizes HTML 属性;这是一系列由逗号分隔的图像条件和尺寸。

HTMLLinkElement.imageSrcset

一个字符串,反映了 imagesrcset HTML 属性;这是一系列由逗号分隔的图像候选字符串。

HTMLLinkElement.integrity

一个字符串,包含浏览器可用于验证已获取资源未被意外篡改的内联元数据。它反映了 <link> 元素的 integrity 属性。

HTMLLinkElement.media

一个字符串,表示资源适用的一个或多个媒体格式列表。它反映了 <link> 元素的 media 属性。

HTMLLinkElement.referrerPolicy

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

HTMLLinkElement.rel

一个字符串,表示文档与资源之间的正向关系。

HTMLLinkElement.relList 只读

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

HTMLLinkElement.sizes 只读

一个 DOMTokenList,反映了 sizes HTML 属性,作为令牌列表。

HTMLLinkElement.sheet 只读

返回与给定元素关联的 StyleSheet 对象,如果不存在则返回 null

HTMLLinkElement.type

一个字符串,表示链接资源的 MIME 类型。

已废弃的属性

HTMLLinkElement.charset 已弃用

一个字符串,表示目标资源的字符编码。

HTMLLinkElement.rev 已弃用

一个字符串,表示从资源到文档的反向关系。

注意:目前 W3C HTML 5.2 规范指出 rev 不再过时,而 WHATWG 生活标准仍将其标记为过时。在解决此差异之前,您仍应假定它是过时的。

HTMLLinkElement.target 已弃用

一个字符串,表示资源适用的目标框架的名称。

实例方法

无特定方法;从其父级 HTMLElement 继承方法。

规范

规范
HTML
# htmllinkelement

浏览器兼容性

另见

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