标签本身不是组件,仅声明静态片段,需配合 document.importnode() 克隆、手动数据填充和挂载才能激活;import() 是 javascript 动态模块加载语法,非 html 功能,必须运行时调用且路径需静态可分析,二者结合 js 逻辑与构建工具链才构成可用组件方案。

<template></template> 不是组件,import() 不是 HTML 功能——这两者必须配合 JS 实例化逻辑和构建工具链才能形成可用的组件方案。
为什么直接写 标签不等于有了组件
浏览器遇到 <template></template> 会跳过解析:里面 <script></script> 不执行、<img> 不加载、data-bind 不生效、表单控件状态(如 <input checked>)也不保留。常见错误是把它当 Vue 的 <template></template> 或 Web Component 的 <slot></slot> 用,结果 DOM 里啥都没有。
- 用
innerHTML = tmpl.innerHTML填充,会丢掉<select></select>当前选中项、<textarea></textarea>输入内容、checked状态 - 用
cloneNode(true)复制,<script></script>和<style></style>仍不会自动执行或生效 - 模板里写
{{title}},纯 HTML + JS 不识别,必须手动遍历querySelectorAll('[data-bind]')替换 - 硬编码
id="card-1",多次复用会导致 ID 冲突,影响 CSS 查询和 JS 获取
如何让 真正“活”起来
核心是两步:用 document.importNode(tmpl.content, true) 安全克隆,再手动填充数据后挂载。它能保留原生表单状态,兼容 Shadow DOM,是微前端中复用模板的底线操作。
- 获取模板:
const tmpl = document.getElementById('card-template') - 克隆内容:
const fragment = document.importNode(tmpl.content, true) - 填充数据:对文本节点用
node.textContent = data.title,对 HTML 内容用node.innerHTML = data.content(注意 XSS 过滤) - 挂载方式必须是
container.appendChild(fragment),禁用innerHTML +=—— 否则已绑定的事件监听器会被销毁 - 若需响应式更新,得缓存首次生成的节点,后续只改
textContent或dataset,不重复克隆
代码分割不能靠 HTML 标签实现,但可以靠 import() 驱动
HTML 本身没有模块加载能力。<script src="big.js"></script> 是同步阻塞加载,不算代码分割;真正的分割必须满足「运行时决定加载」+「不提前下载未用部分」。
-
import()必须写在函数或事件回调里,不能放在顶层作用域,否则 Webpack/Vite 无法识别为动态导入 - 路径必须是字符串字面量:
import('./chart.js')✅,import('./' + name + '.js')❌(构建工具无法静态分析) - 加载失败必须显式
.catch(),否则控制台静默报错、页面卡死:import('./modal.js').catch(() => el.innerHTML = '<div class="error">加载失败</div>') - 纯 HTML 片段(无 JS 逻辑)可改用
fetch('./header.html').then(r => r.text()).then(html => el.insertAdjacentHTML('beforeend', html)),更轻量且绕过 CSP 限制 - URL 路径以入口 HTML 所在目录为基准,不是 JS 文件位置;要用
new URL('./footer.html', import.meta.url)构造绝对路径
真正容易被忽略的是资源生命周期和样式边界
哪怕用了 <template></template> + import(),如果 Custom Element 实例被移除时没在 disconnectedCallback 里清理 IntersectionObserver、定时器或事件监听器,内存泄漏就藏在那儿。而样式隔离更隐蔽:不加 attachShadow({ mode: 'closed' }),<template></template> 克隆后插入 light DOM,照样被主应用全局样式穿透,.ant-btn 还是会生效。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











