Shadow DOM 通过浏览器原生机制实现样式彻底隔离：外部 CSS 无法进入、内部 CSS 无法泄露；必须用 attachShadow({ mode: 'open' }) 创建影子根，内联样式需注入 shadowRoot，仅 :host 和 ::slotted 允许有限穿透。
直接用 attachShadow({ mode: 'open' }) 创建影子根，并把编辑器的 HTML 结构、<style> 和初始化脚本全部注入其中，就能阻断外部 CSS 进入、内部 CSS 泄漏——这是浏览器原生机制，不是 hack。
为什么编辑器必须挂载在 Shadow DOM 里
HTML 编辑器（如 TinyMCE、Quill 或自研富文本组件）通常自带重置样式（*, body, p, ul { margin: 0; padding: 0; }）和全局类名（.ql-editor, .mce-content-body）。一旦通过 innerHTML 或 v-html 直接插入主文档，这些规则立刻污染全局，导致宿主页面的段落间距消失、列表缩进错乱、字体继承异常。
Shadow DOM 是唯一能从渲染引擎层面切断这种污染的方案：它让编辑器的样式计算完全独立于 document.styleSheets，连 !important 都无效——不是权重不够，是压根没被解析。
- 外部
body { font-family: "Helvetica"; }对 shadow 内的<p>无影响 - 编辑器内
button { background: blue; }不会覆盖宿主页面的button.primary -
document.querySelector('.ql-toolbar')查不到 shadow 内元素，除非显式传入shadowRoot
如何安全注入编辑器 HTML 和样式
不能对 shadowRoot 直接赋值 innerHTML = htmlString，尤其当字符串含 <script>、<link> 或内联 <style> 时——它们不会执行，还可能触发 CSP 报错。
立即学习“前端免费学习笔记（深入）”；
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
正确做法是用 <template> + cloneNode()，再手动处理资源：
- 把编辑器完整 HTML（含
<div class="ql-container">...</div>和内联<style>）写进<template>标签 - 用
template.content.cloneNode(true)拷贝节点树 - 遍历克隆后的节点，对每个
<style>调用shadowRoot.appendChild(style)；对每个<script>，创建新script元素并appendChild到shadowRoot - 禁止把
<link rel="stylesheet">插入shadowRoot.innerHTML——它会加载到全局，失去隔离意义
编辑器 JS 初始化必须限定在 shadow 内部作用域
第三方编辑器常依赖 document 查找容器，比如 new Quill('#editor') 或 tinymce.init({ selector: '.tinymce' })。若在 shadow 中直接运行，它会去主文档找 #editor，找不到就报错或初始化失败。
解决方法只有两个，且必须选其一：
- 改用支持容器参数的初始化方式：
new Quill(shadowRoot.querySelector('.ql-editor'))，把查找范围锁死在 shadow 内 - 若框架不支持（如旧版 TinyMCE），需包裹初始化逻辑：
const editorEl = shadowRoot.querySelector('.tinymce'); tinymce.init({ target: editorEl }); - 绝对不要在
connectedCallback里反复调用attachShadow()——每次 DOM 插入都会触发，必然报Failed to execute 'attachShadow' on 'Element': Shadow root has already been attached - 避免使用
mode: 'closed'：它让element.shadowRoot返回null，调试时看不到#shadow-root节点，自动化测试也无法访问，对防污染毫无增益
容易被忽略的继承性泄漏点
Shadow DOM 隔离的是选择器作用域，但部分 CSS 属性仍会从宿主继承，比如 font-family、color、line-height、direction。编辑器内容若显示异常（如中文字体变成等宽、颜色变灰），大概率是这个原因。
修复方式不是“清空所有继承”，而是精准控制：
- 在
:host上显式重设关键继承属性：:host { font-family: -apple-system, BlinkMacSystemFont, sans-serif; color: #333; } - 禁用不必要的继承：
:host { all: unset; }会清除display和position，导致布局崩溃，慎用 - 若需透传主题（如宿主有
.dark类），用:host-context(.dark) { color: #eee; }，而非错误的:host(.dark)（它只查宿主自身是否有该类） -
::slotted(p)只能设color、font等继承属性，不能设margin或display——这是规范限制，强行写无效
