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。
同类文章
Less如何提升CSS维护性_使用参数化Mixin实现灵活组件
Less参数化Mixin:如何写出既灵活又可控的样式代码? Less参数化Mixin怎么写才不重复造轮子 开门见山,参数化Mixin的核心目标不是炫技,而是解决一个实际问题:把那些“可能会变”的样式值抽离出来。这样一来,样式规则只需定义一次,修改时就能全局生效,维护效率自然就上去了。关键在于,你得准
Vue 中的 Patch 过程是怎么工作的?从 VNode 到真实 DOM 的转化全指南
Vue 中的 Patch 过程是怎么工作的?从 VNode 到真实 DOM 的转化全指南 Patch 的核心目标:高效更新 DOM 简单来说,Vue 的 Patch 过程干的就是一件“聪明事”:它拿着新旧两份虚拟节点(VNode)清单,只去更新真实 DOM 里真正变了的那部分,而不是不管三七二十一,
CSS如何实现移动端加载占位骨架屏_利用CSS渐变色与动画效果
CSS如何实现移动端加载占位骨架屏:利用渐变色与动画效果 先明确一个核心概念:一个真正好用的骨架屏,本质上不是图片,而是用CSS背景渐变“画”出来的容器轮廓。关键在于,如何让background-image精准覆盖真实内容区域,同时巧妙地利用透明间隙来模拟文字或头像的留白。这听起来简单,但实际操作时
CSS如何实现侧边栏推拽切换_利用CSS动画平滑过渡布局
侧边栏推拽用 transform: translateX() 更流畅,避免 left margin-left 触发重排;初始隐藏用 translateX(-100%),配合 ease-out 或自定义 cubic-bezier 过渡更自然;移动端需谨慎 preventDefault() 并启用 -w
Ionic 7 中在 Tab 内实现页面内导航的完整教程
Ionic 7 中在 Tab 内实现页面内导航的完整教程 本文详解如何在 Ionic 7(Vanilla JS)中为单个 Tab 配置独立的嵌套路由系统,解决 ion-router 在 ion-tab 内无法正常跳转的问题,并提供可运行的结构化实现方案。 如果你正在用 Ionic 7 的纯 Ja v
- 日榜
- 周榜
- 月榜
1
2
3
4
5
6
7
8
9
10
1
2
3
4
5
6
7
8
9
10
相关攻略
2015-03-10 11:25
2015-03-10 11:05
2021-08-04 13:30
2015-03-10 11:22
2015-03-10 12:39
2022-05-16 18:57
2025-05-23 13:43
2025-05-23 14:01
热门教程
- 游戏攻略
- 安卓教程
- 苹果教程
- 电脑教程
热门话题

