HTML中template列表渲染 HTML中template标签结合原生JS
HTML中template列表渲染:HTML中template标签结合原生JS

先明确一个核心概念:template标签本身在浏览器里是“隐身”的。它不渲染、不执行、也不做任何数据绑定,本质上就是一个离线的结构仓库。想用它来实现列表渲染?必须依靠Ja vaScript手动完成克隆、填充数据和插入DOM这三步。直接在template里写for循环或者类似{{name}}的插值语法是完全无效的,浏览器会原封不动地忽略它们。
为什么说template.content.cloneNode(true)是唯一可靠的入口?
很多人第一步就卡住了:试图用document.querySelector('template').innerHTML来获取内容,结果却拿到一个空字符串。问题出在哪?原来,template标签的真实内容被浏览器封装在一个叫做DocumentFragment的容器里,只有通过其content属性才能访问到。
template.innerHTML永远为空,这个属性根本用不上。template.textContent倒是能返回所有文本(包括换行和缩进),但你无法用它来操作DOM结构。- 所以,必须走
template.content.cloneNode(true)这条路。这是获取可操作节点副本的唯一正确方式,否则后续所有操作都将失效。 - 这里有个关键细节:
cloneNode方法的参数必须是true,表示深度克隆。如果用了false或省略,只会克隆模板节点本身,其所有子元素、事件监听器、表单状态(比如input的光标位置)都会丢失。
填充数据时,请对innerHTML保持警惕
拿到克隆节点后,下一步是填充数据。这时候,innerHTML是一个需要谨慎使用的工具。直接用字符串拼接赋值,等于主动打开了XSS(跨站脚本攻击)的风险大门。更隐蔽的问题是,它会销毁目标元素内已有的DOM结构,如果克隆的模板里原本有带事件监听的button,这些监听器也会一并被清除。
- 纯文本内容:优先使用
textContent。例如:el.querySelector('.title').textContent = data.title。 - 表单控件值:对于
input、textarea等,应该设置value属性,而不是textContent。例如:el.querySelector('input').value = data.value。 - 如果内容确实包含需要保留的HTML结构怎么办?务必先对用户输入进行转义处理(例如将
&转换为&),然后再赋值给innerHTML。 - 另外请注意,即使模板里包含了
或标签,cloneNode(true)也不会执行其中的脚本或重复加载样式。别指望克隆出来的节点会让这些代码“活”起来。
批量插入的秘诀:善用DocumentFragment提升性能
当需要渲染大量列表项时,性能问题就凸显出来了。如果在循环里每生成一个节点,就立刻用container.appendChild(cloned)插入到页面,会导致浏览器频繁进行重排(Reflow)和重绘(Repaint)。数据量小或许感觉不到,一旦达到上百条,卡顿就会非常明显;如果是几百条,页面响应基本就卡死了。
立即学习“前端免费学习笔记(深入)”;
- 正确的做法是引入
DocumentFragment作为轻量级的中间容器:const frag = document.createDocumentFragment()。 - 在循环体内,完成克隆和填值后,将节点追加到这个片段中:
frag.appendChild(cloned)。 - 循环结束后,只执行一次插入操作:
container.appendChild(frag)。 DocumentFragment本身不在DOM树中,也无法被querySelector查到,因此这个操作过程不会触发额外的渲染,可以放心使用。
关于data属性和slot:别混淆了概念
想在克隆的节点上存储一些元信息,比如ID或索引?使用data-*属性(如data-id)是可行的,它们会被保留在克隆后的节点上。但要注意,这些属性不会自动变成Ja vaScript对象的属性,你需要通过dataset来访问。
至于slot,情况就不同了。原生的template标签并不激活Web Components的插槽机制——因为它没有被挂载到Shadow DOM中,所以像slot="xxx"这样的属性根本不会被解析。
- 存储元信息:使用
cloned.querySelector('li').dataset.id = item.id。 - 避免无效查询:不要写
cloned.querySelector('[slot="title"]')这样的代码,你永远找不到目标元素。 - 如果真的需要插槽功能,那意味着你需要完整地使用Web Components技术栈,即结合
customElements.define()和attachShadow()来定义自定义元素。这已经超出了纯template列表渲染的讨论范围。
最后,一个最容易被忽略的要点是:每次循环都必须克隆一个全新的节点副本。共用一个节点引用、忘记调用cloneNode(true)、或者在循环外提前获取了content,都会导致最终页面上只显示最后一项数据,或者出现各种DOM状态错乱。这并非bug,而是template标签的设计初衷:它不维护任何响应式状态,只是为你提供一个干净、可复用的原始结构骨架。
游乐网为非赢利性网站,所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系youleyoucom@outlook.com。
同类文章
checked表单属性与CSS变量实现换肤原理
先聊一个有意思的现象:不需要编写任何 JavaScript,仅靠一个 :checked 伪类,就能驱动整个主题切换系统。听起来很神奇,但原理其实并不复杂——核心在于,:checked 是浏览器原生状态的实时镜像,而不是 JS 模拟出来的开关。 用户点击 ,或者用键盘空格键选中它,状态更新的那一刻,C
HTML meta标签页面定时跳转实现
说到前端开发中最简洁的页面跳转方式,meta http-equiv= "refresh " 绝对算得上一个经典方案。不过别看它结构简单,格式上稍有疏忽,页面就可能原地卡死,或者直接跳到一个错误地址。下面把几个最容易踩坑的细节彻底讲清楚,帮你避开这些常见陷阱。 使用 http-equiv= "refresh
Cypress跨测试用例状态传递的不推荐但可选方案
Cypress 默认的设计哲学很干脆:每个测试用例都必须是独立小王国,谁也不靠谁。这意味着 it() 执行前,浏览器上下文会被“一键还原”——页面状态、LocalStorage、Cookies 统统清空,强制维护测试隔离。这一规则让很多新手头疼:明明前一个测试已经创建了员工,后一个测试怎么就没法直接
全面深度解析HTML主体main标签唯一性原则与使用规范
在进行前端无障碍审计时,不少开发者会遇到一个奇怪的场景:浏览器不报错,但Lighthouse却直接标红“duplicate-main”。这其实是语义层与渲染层之间的根本差异。 为什么浏览器不报错但 Lighthouse 直接标红 duplicate-main 关键原因就在于:`main` 是语义锚点
HTML main标签在文档结构中的唯一性详解
先做一个快速检测:打开你最近开发的一个页面,按下 Ctrl+F 搜索 。如果搜索结果里出现2个以上,那这篇文章建议你认真读完。 本期要聊的主题,是HTML标签中一个看似简单、实际极易踩坑的核心知识点:main标签的唯一性。很多开发者知道这个标签的存在,但真正写到项目里,尤其是用了React、Vue这
- 日榜
- 周榜
- 月榜
相关攻略
2026-07-02 06:55
2026-07-02 06:54
2026-07-02 06:54
2026-07-02 06:54
2026-07-02 06:54
2026-07-02 06:54
2026-07-02 06:54
2026-07-02 06:54
热门教程
- 游戏攻略
- 安卓教程
- 苹果教程
- 电脑教程
热门话题

