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 貢獻者修改。