ShadowRoot: serializable 屬性

Baseline 2024
新推出

自 2024 年 9 月起,此功能已可在最新裝置和瀏覽器版本上使用。此功能可能無法在舊裝置或瀏覽器上使用。

serializableShadowRoot 介面的一個只讀屬性,如果 shadow root 可序列化,則返回 true

如果設定了此屬性,可以透過呼叫 Element.getHTML()ShadowRoot.getHTML() 方法,並將 options.serializableShadowRoots 引數設定為 true 來序列化 shadow root。

shadow root 的 serializable 屬性是在建立 shadow root 時指定的,可以透過以下兩種方式:在 <template> 元素上新增 shadowrootserializable 屬性(以及一個允許的 shadowrootmode 值)以宣告方式建立,或者在使用 Element.attachShadow() 時將 options.serializable 引數設定為 true

如果 shadow root 可序列化,則為 true;否則為 false

示例

js
const customElem = document.querySelector("my-shadow-dom-element");
const shadow = customElem.shadowRoot;

// …

// Is it serializable?
const hostElem = shadow.serializable;

規範

規範
DOM
# dom-shadowroot-serializable

瀏覽器相容性