JavaScript操作Shadow DOM需先用attachShadow()创建影子根并指定open/closed模式,再通过shadowRoot使用标准DOM方法操作;两者与主DOM隔离,可通过自定义事件、slot和:host等机制通信与样式穿透。
JavaScript操作Shadow DOM主要靠 attachShadow() 创建影子根,再用标准DOM方法往里面添加和查询元素。
调用 element.attachShadow() 方法为元素挂载影子根。必须传入 {mode: 'open'} 或 {mode: 'closed'}:
element.shadowRoot 直接访问影子根,支持常规DOM操作shadowRoot 返回 null,外部JS无法访问内部结构(仅组件内部能操作)示例:
const host = document.getElementById('my-host');
const shadow = host.attachShadow({ mode: 'open' }); // 创建open模式Shadow DOM
shadow.innerHTML = `Hello from Shadow DOM!
`;
一旦拿到 shadowRoot,就能像操作普通DOM一样使用 querySelector、appendChild、addEventListener 等方法:
shadow.appendChild(document.createElement('div'))
shadow.querySelector('button')(只在影子树内查找)shadow.addEventListener('click', handler),或绑定到内部按钮上注意:document.querySelector() 查不到影子树里的节点,反之亦然——两者是隔离的。
Shadow DOM默认有样式和脚本作用域隔离,但仍有可控方式交互:
自定义事件 向外派发:host.dispatchEvent(new CustomEvent('data-ready', { detail: data }))
占位,外部内容自动渲染其中:host 选中宿主元素,::slotted(p) 可样式化插槽中的p标签,但无法用外部CSS直接选中内部元素Chrome/Firefox开发者工具默认会显示Shadow DOM(需开启“Show user agent shadow DOM”设置):
$0.shadowRoot(选中宿主元素后),快速访问当前影子根基本上就这些。不复杂但容易忽略mode选项和作用域边界。