HTML中template标签定义不渲染内容模板的用法

老辰姑娘_5418

老辰姑娘_5418

2026-06-03

448人浏览

原创

template标签不渲染内容,因其内容被转为离线documentfragment挂载在content属性上;需通过content.clonenode(true)克隆后插入dom,否则无效。

html中template标签定义不渲染内容模板的用法

template 标签不是“隐藏元素”,它根本不会进入 DOM;想复用,必须通过 content.cloneNode(true) 克隆后插入,否则什么都不会出现。

为什么直接写 template 里什么也不显示

浏览器解析到 <template></template> 时,会把内部所有内容转为一个离线的 DocumentFragment,挂载在 content 属性上。这个过程不创建真实节点、不执行 <script></script>、不加载 <img src>、不触发任何事件绑定——它只是“存着”,连 document.getElementById() 都查不到里面写的 ID。

  • template.innerHTML 永远是空字符串,别试
  • template.children 是空的 NodeList,因为子节点全在 content 里
  • 把 <template><div id="x"></div></template> 放进页面后,document.getElementById('x') 返回 null

怎么安全取出并插入模板内容

必须走 content → cloneNode(true) → 插入目标容器 这条路径,缺一不可。

职徒简历
职徒简历

职徒简历是一款AI求职招聘工具,智能简历制作软件,基于GPT的简历优化和简历代写。

下载
  • 获取模板:const tmpl = document.querySelector('#my-tmpl')
  • 克隆内容:const frag = tmpl.content.cloneNode(true)(不能省略 true,否则只浅克隆)
  • 插入 DOM:container.append(frag) 或 container.appendChild(frag)
  • 错误写法:container.appendChild(tmpl) —— 模板本身是元素,但没内容;container.appendChild(tmpl.content) —— 只能插入一次,第二次就失效

含表单或交互元素时容易漏掉的初始化步骤

克隆出来的 <input>、<select></select>、<textarea></textarea> 保留的是 HTML 中定义的初始 value 或 checked,不是用户当前输入值;事件监听器也不会自动带上。

  • 手动设值:frag.querySelector('input').value = user.inputValue
  • 手动绑定事件:frag.querySelector('.btn').addEventListener('click', handler),或改用事件委托
  • 注意 cloneNode(true) 不复制运行时状态,比如已选中的 radio、滚动位置、focus 状态等

兼容性和结构陷阱

template 在 IE 中完全不可用,Edge 13+、Chrome 26+、Firefox 22+、Safari 7.1+ 支持良好,但有几个硬伤常被忽略:

  • 不能作为 <table> 的直接子元素:<code><table><template>...</template></table> 会被浏览器自动提到 <table> 外,结构错乱 <li>不能放在 <code><script></script>、<style></style>、<iframe></iframe> 内部,否则解析失败
  • 服务端渲染(SSR)时,template 标签会被原样输出,客户端 JS 必须确保在 DOM 加载完成后才访问 content
  • 真正容易被忽略的一点:你每次都要重新 cloneNode(true),不能缓存 tmpl.content 直接反复插入——它是个单次使用的 DocumentFragment,插完就空了。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

5935

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

3332

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

3010

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

3039

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4819

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

2981

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

2789

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2468

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2528

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习