讲解如何利用ES6模板字符串结合insertAdjacentHTML与template标签简化原生JavaScript中动态创建DOM元素的过程,提供完整对比代码、操作步骤与XSS防御策略。
使用JS模板字符串简化DOM元素动态创建代码示例
时间:2026-11-19
浏览:134
文章目录
在原生 JavaScript 开发中,向页面动态添加复杂的 HTML 结构通常面临代码冗长与可读性差的难题。传统方式依赖 document.createElement() 逐层创建节点、配置属性并逐级 appendChild(),一旦节点层级加深,不仅编写繁琐,而且无法直观看出最终的 DOM 骨架。ES6 模板字符串(Template Literals)提供了声明式的语法表达,结合 insertAdjacentHTML() 或 <template> 元素,可以像编写普通 HTML 一样直观组织结构并内联动态变量,使 DOM 动态创建代码精简 60% 以上。
传统 DOM 创建方式的瓶颈
在没有模板字符串前,若需要动态创建一个展示用户资料的卡片组件,包含头像、标题、介绍文本与按钮,典型的原生实现如下:
// 传统 createElement 方式
function createUserCard(user) {
const card = document.createElement('div');
card.className = 'user-card';
const avatar = document.createElement('img');
avatar.src = user.avatarUrl;
avatar.alt = user.name;
card.appendChild(avatar);
const infoDiv = document.createElement('div');
infoDiv.className = 'info';
const title = document.createElement('h3');
title.textContent = user.name;
infoDiv.appendChild(title);
const desc = document.createElement('p');
desc.textContent = user.bio;
infoDiv.appendChild(desc);
const btn = document.createElement('button');
btn.type = 'button';
btn.className = 'btn-follow';
btn.textContent = '关注';
infoDiv.appendChild(btn);
card.appendChild(infoDiv);
return card;
}
// 挂载到页面
const container = document.getElementById('user-list');
container.appendChild(createUserCard({
name: '李工',
avatarUrl: '/images/avatar1.png',
bio: '前端架构师,专注于现代化 Web 性能'
}));
从上面的示例可以看出,这类代码存在三个明显的痛点:
- 结构破碎且不可视:完整的 HTML 树被拆解为数十行连续的 API 调用,无法一眼看清父子层级关系。
- 维护成本高:若需要调整样式类名或调整标签嵌套层次,需要精准修改对应的变量关系,极易引发挂载遗漏。
- 编写繁重:即便添加一个简短的内联标签,也需要完整的创建、赋值和追加三个步骤。
方案一:模板字符串配合 insertAdjacentHTML 快速挂载
在大多数动态插入元素的场景中,推荐使用 element.insertAdjacentHTML(position, text) 代替直接修改 innerHTML。直接给父容器赋值 container.innerHTML += template 会强制销毁容器内所有的既有 DOM 节点并重新解析渲染,这会导致容器内原有的表单输入内容丢失、已绑定的事件监听器全部失效。而 insertAdjacentHTML 会将解析后的节点直接插入到指定的相对位置,完全不破坏既有元素。
标准操作步骤
- 定位挂载容器:使用
document.querySelector()获取需要插入子节点的目标 DOM 元素。 - 构建模板字符串:使用反引号(
`)定义多行 HTML 模板,利用${}语法将动态字段注入到标签属性或文本节点中。 - 指定插入位置:依据业务布局选择合适的位置参数(通常使用
'beforeend'追加至末尾)。 - 调用方法执行插入:调用
container.insertAdjacentHTML('beforeend', markup)完成挂载。
完整代码示例
// 模拟接收到的用户对象数据
const userData = {
id: 1024,
name: '王小伟',
role: '资深全栈工程师',
avatar: 'https://cdn.example.com/avatars/user-1024.jpg',
tags: ['JavaScript', 'Node.js', 'CSS']
};
/**
* 使用模板字符串生成 HTML 并挂载到目标容器
* @param {HTMLElement} targetContainer 目标 DOM 容器
* @param {Object} user 用户信息对象
*/
function renderUserProfile(targetContainer, user) {
// 利用 map 与 join 处理内联数组,三元运算符处理标签样式
const tagsHtml = user.tags
.map(tag => `<span class="badge">${tag}</span>`)
.join('');
const template = `
<div class="user-profile-card" data-user-id="${user.id}">
<div class="avatar-box">
<img src="${user.avatar}" alt="${user.name} 的头像" />
</div>
<div class="content-box">
<h3 class="user-name">${user.name}</h3>
<p class="user-role">${user.role}</p>
<div class="tag-group">
${tagsHtml}
</div>
</div>
<button type="button" class="action-btn" data-action="contact">发送消息</button>
</div>
`;
// 直接将 HTML 字符串插入到容器末尾
targetContainer.insertAdjacentHTML('beforeend', template);
}
// 执行挂载
const containerEl = document.querySelector('#cards-container');
renderUserProfile(containerEl, userData);
在上述代码中,整个卡片的骨架、标签内嵌逻辑和属性赋值都在一个反引号代码块中完成。相比于传统的二十余行 createElement,此方案代码结构紧凑,不仅容易阅读,日后修改样式类名或新增排版标签也极为直观。
方案二:模板字符串结合 <template> 获取真实 DOM 对象
虽然 insertAdjacentHTML 非常适合直接将元素刷入页面,但在某些业务场景中,开发者需要在元素被添加到 DOM 树之前获取其真实的对象引用(例如为了直接调用 addEventListener 绑定私有作用域事件,或者获取特定子元素的精确度量尺寸)。此时,直接使用 HTML5 原生的 <template> 标签是最规范高效的方案。
<template> 元素包裹的内容被浏览器视为惰性文档片段(DocumentFragment)。它不会发起网络请求(例如其中的 <img> 此时不会加载图片),也不会在 DOM 树中渲染,只驻留在内存中等待被克隆或提取。
通用元素转换函数与事件绑定
我们可以将 <template> 封装为一个极小的通用转换工具函数 createElementFromHTML,它接收模板字符串,返回完全实例化的原生 HTMLElement:
/**
* 将 HTML 模板字符串快速转换为真实的 DOM 节点
* @param {string} htmlString 单个根节点的 HTML 字符串
* @returns {HTMLElement} 实例化后的 DOM 元素
*/
function createElementFromHTML(htmlString) {
const template = document.createElement('template');
// 去除首尾空白字符,避免将文本节点当作 firstElementChild
template.innerHTML = htmlString.trim();
return template.content.firstElementChild;
}
// 实际使用示例:创建元素并立即绑定私有事件
function createInteractiveAlert(message, level = 'info') {
const markup = `
<div class="custom-alert alert-${level}">
<span class="alert-icon">ℹ</span>
<span class="alert-text">${message}</span>
<button type="button" class="alert-close-btn" aria-label="关闭">×</button>
</div>
`;
// 1. 将模板字符串转化为真实 DOM
const alertEl = createElementFromHTML(markup);
// 2. 直接获取内部子节点并绑定事件处理逻辑
const closeBtn = alertEl.querySelector('.alert-close-btn');
closeBtn.addEventListener('click', () => {
alertEl.style.opacity = '0';
setTimeout(() => alertEl.remove(), 200);
});
return alertEl;
}
// 挂载使用
const app = document.getElementById('notification-center');
const alertNode = createInteractiveAlert('保存成功!您刚才提交的数据已入库。', 'success');
app.appendChild(alertNode);
通过这种方式,既享受了模板字符串直观书写 HTML 结构的声明式红利,又完整保留了对原生 DOM 节点的编程控制能力,在构建弹窗、通知条或复杂自定义组件时格外高效。
复杂数据场景:列表渲染与嵌套组件化
在实际应用中,页面数据往往以对象数组的形式呈现(例如从后端 API 接口返回的商品列表、评论数据)。结合 JavaScript 的数组方法 map(),模板字符串能够以非常紧凑的形式完成批量循环渲染。
// 模拟商品数据列表
const products = [
{ id: 1, title: '机械键盘', price: 299, inStock: true, discount: null },
{ id: 2, title: '人体工学椅', price: 1299, inStock: false, discount: '限时 8 折' },
{ id: 3, title: '4K 显示器', price: 1899, inStock: true, discount: '满减优惠' }
];
/**
* 单个商品的子模板函数
*/
function renderProductItem(item) {
return `
<li class="product-item ${item.inStock ? 'is-available' : 'is-soldout'}" data-id="${item.id}">
<div class="item-header">
<h4 class="title">${item.title}</h4>
${item.discount ? `<span class="discount-tag">${item.discount}</span>` : ''}
</div>
<div class="item-footer">
<span class="price">¥${item.price.toFixed(2)}</span>
<button class="btn-buy" ${!item.inStock ? 'disabled' : ''}>
${item.inStock ? '加入购物车' : '已售罄'}
</button>
</div>
</li>
`;
}
/**
* 完整列表模板渲染函数
*/
function renderProductList(container, list) {
if (!list || list.length === 0) {
container.innerHTML = `<div class="empty-state">暂无商品数据</div>`;
return;
}
// 重点:使用 map 映射后必须调用 .join(''),否则数组默认调用 toString() 会产生逗号 ','
const listItemsMarkup = list.map(renderProductItem).join('');
const fullMarkup = `
<section class="product-shelf">
<h3 class="shelf-title">今日推荐列表 (共 ${list.length} 件)</h3>
<ul class="product-grid">
${listItemsMarkup}
</ul>
</section>
`;
container.innerHTML = fullMarkup;
}
// 执行渲染
const listContainer = document.querySelector('#product-shelf-root');
renderProductList(listContainer, products);
避坑提示:在插值表达式内使用 array.map() 时,千万不要忘记在末尾链式调用 .join('')。如果省略 .join(''),JavaScript 模板字符串在对数组求值时会默认调用 Array.prototype.toString(),导致渲染出的 HTML 节点之间夹杂许多多余的逗号字符。
安全防范:规避 XSS 风险与性能最佳实践
利用模板字符串构建 DOM 带来开发效率极大提升的同时,也引入了与 innerHTML 类似的安全隐患:跨站脚本攻击(Cross-Site Scripting, XSS)。如果模板字符串中嵌入的变量来源于不可信的外部输入(如 URL 参数、用户提交的昵称、富文本评论等),恶意用户可能通过注入 <img src="x" onerror="..."> 或 <script> 标签执行攻击代码。
1. 编写字符转义函数
对于不可信的文本数据,在插入模板之前必须经过 HTML 实体转义。以下是一个轻量、快速的转义实现:
/**
* 转义特殊 HTML 字符以防范 XSS 注入
* @param {string} str 待转义的原始字符串
* @returns {string} 安全的转义字符串
*/
function escapeHTML(str) {
if (typeof str !== 'string') return str;
return str.replace(/[&<>"']/g, match => {
switch (match) {
case '&': return '&';
case '<': return '<';
case '>': return '>';
case '"': return '"';
case "'": return ''';
default: return match;
}
});
}
// 使用示例:防止恶意脚本执行
const untrustedInput = `<img src=x onerror="alert('XSS!')"> 恶意用户`;
const safeCardHTML = `
<div class="comment">
<span class="author">${escapeHTML(untrustedInput)}</span>
</div>
`;
2. 结合事件委托统一管理事件
当使用模板字符串一次性生成包含大量按钮或交互项的列表时,不要在模板字符串中编写内联的 onclick="handle(...)"。内联事件不仅污染全局作用域,而且无法获取清晰的闭包上下文。推荐采用事件委托(Event Delegation)模式,仅在父容器上监听事件:
const listRoot = document.querySelector('#product-shelf-root');
// 统一监听父容器,通过 data-action 属性分发交互
listRoot.addEventListener('click', (event) => {
const buyBtn = event.target.closest('.btn-buy');
if (!buyBtn || buyBtn.disabled) return;
const itemEl = buyBtn.closest('.product-item');
const productId = itemEl.dataset.id;
console.log(`用户点击购买了商品 ID: ${productId}`);
});
方案对比与选型参考
在面对不同开发规模与业务场景时,可以通过下表明确选择依据:
| 实现方式 | 代码可读性 | 性能表现 | 事件绑定支持 | 最佳适用场景 |
|---|---|---|---|---|
| createElement + appendChild | 差(随嵌套加深急剧变差) | 极高(直接操作原生对象) | 原生支持(每个节点都有引用) | 极少复杂属性的极简节点(如单创建单个 span) |
| 模板字符串 + insertAdjacentHTML | 优(声明式结构所见即所得) | 高(底层 C++ 一次性快速解析) | 需结合事件委托 | 列表渲染、局部页面追加、绝大多数通用展示组件 |
| 模板字符串 + <template> | 优(结构直观,支持组件封装) | 高(惰性内存解析,无渲染重排) | 支持(转换为原生 Element 后直接绑定) | 弹窗、浮层、需要在插入页面前精确控制的复合组件 |
掌握 ES6 模板字符串与现代 DOM API 的协同使用,可以在无需引入重量级前端框架的前提下,写出优雅、结构清晰且高效的原生组件创建逻辑。在日常开发中,优先使用 insertAdjacentHTML 搭配事件委托来满足常见内容渲染,在需要对象级操作时借力 <template>,并始终贯彻 XSS 输入转义与数组 join('') 清理,就能兼顾开发效率与工程稳定性。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。