template.content.cloneNode(true)是唯一合法激活路径,直接读innerHTML为空、textContent仅含文本、content为单次消耗品,克隆后需手动处理script/img/iframe等惰性资源,批量渲染必须用DocumentFragment。

template.content.cloneNode(true) 是唯一合法激活路径
直接读 template.innerHTML 永远是空字符串,这不是 bug,是规范行为。浏览器把模板内容封装成只读的 DocumentFragment,不暴露给字符串接口。template.textContent 虽能拿到文本(含换行缩进),但无法操作节点结构。
真正可用的入口只有 template.content,但它不能直接插入 DOM——它是“单次消耗品”:一旦被 appendChild() 移走,再取就是空的。
- ❌ 错误写法:
const content = tmpl.content; parent.appendChild(content)→ 第二次调用就失效 - ✅ 正确写法:
parent.appendChild(tmpl.content.cloneNode(true))→ 每次都重新克隆 - 必须传
true:否则只克隆标签自身,内部结构全丢 -
、的初始值和焦点状态,只在深克隆后保留
template 里的 script 和 img 不会自动执行或加载
的惰性设计意味着:内部的 <script></script> 不执行、 不发起请求、 不加载、 不生效。这些行为只有在克隆后挂入真实 DOM 才触发——但也不是“自动活过来”,你得手动干预。
- 脚本需显式执行:遍历克隆后的
script节点,用document.createElement('script')复制属性并注入,避免eval()引入 XSS - 图片懒加载要提前加
loading="lazy"或改用data-src,否则一插入就立刻请求 -
推荐用srcdoc占位,等需要时再赋值src - Web Components(如
)的connectedCallback只在首次插入时触发,确保插入动作在所有初始化逻辑之后
批量渲染必须用 DocumentFragment,否则性能崩得快
100 条数据循环里每轮都 container.appendChild(cloned),等于让浏览器反复重排重绘,滚动卡顿、内存飙升几乎是必然结果。
- ✅ 正确流程:
const frag = document.createDocumentFragment()→ 循环内frag.appendChild(cloned)→ 循环结束再container.appendChild(frag) -
DocumentFragment是轻量中间容器,不在 DOM 树中,也不响应querySelector - 填值优先用
textContent和value,别碰innerHTML:前者防 XSS,后者会销毁已绑定事件和节点引用 - 需要渲染 HTML 片段?先对用户输入做转义(如
text.replace(/&/g, '&')),再塞进innerHTML
嵌套 template 不会自动递归展开
HTML5 规范里没有“模板编译”机制。 里再套 ,它就真的只是静态字符串——cloneNode(true) 后,子 仍是未实例化的文本节点, 和绑定语法(如 {{item.name}})完全不生效。
- 树形菜单、嵌套评论这类场景,必须手写 JS 遍历数据、匹配模板、克隆、填充、再递归处理子节点
- 没有捷径,浏览器不代劳;也没有上下文传递或作用域继承
- 常见错误:以为
template.content.querySelector('template')能拿到可操作子模板——其实拿到的是未激活的片段,还得再.cloneNode(true)
最容易被忽略的是:克隆后的节点一旦插入 DOM,所有资源加载、脚本执行、组件升级就不可逆地触发了。时机控制错了,懒加载就变成预加载,惰性就失去意义。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











