HTMLLinkElement: blocking 属性

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

HTMLLinkElement 接口的 blocking 属性是一个字符串，用于指示在获取外部资源时应阻止的某些操作。

它反映了 <link> 元素的 blocking 属性。

值

一个字符串。必须是以空格分隔的下面列出的 blocking tokens 的列表，用于指示要阻止的操作

render: 阻止在屏幕上渲染内容。

注意：只有文档 <head> 中的 link 元素才有可能阻止渲染。默认情况下，在 <head> 中设置了 rel="stylesheet" 的 link 元素会在浏览器解析时发现它，从而阻止渲染。如果此类 link 元素是通过脚本动态添加的，您还必须将其 blocking 设置为 "render" 才能阻止渲染。

html

<link
  id="el"
  rel="stylesheet"
  href="/example.css"
  blocking="render"
  crossorigin />

const el = document.getElementById("el");
console.log(el.blocking); // Output: "render"

规范
HTML # dom-link-blocking

此页面最后修改于 2025年8月13日，由 MDN 贡献者修改。