使用JS模板字符串简化DOM元素动态创建代码示例

作者:像素漫游

时间:2026-11-19

浏览:134

讲解如何利用ES6模板字符串结合insertAdjacentHTML与template标签简化原生JavaScript中动态创建DOM元素的过程,提供完整对比代码、操作步骤与XSS防御策略。

文章目录
分类:前端开发教程 技术要点:ES6 模板字符串 / DOM API / 性能优化
使用JS模板字符串简化DOM元素动态创建代码示例

在原生 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 调用,无法一眼看清父子层级关系。
  • 维护成本高:若需要调整样式类名或调整标签嵌套层次,需要精准修改对应的变量关系,极易引发挂载遗漏。
  • 编写繁重:即便添加一个简短的内联标签,也需要完整的创建、赋值和追加三个步骤。
使用JS模板字符串简化DOM元素动态创建代码示例
图 1:原生 createElement 逐层拼装与模板字符串声明式解析的结构对比

方案一:模板字符串配合 insertAdjacentHTML 快速挂载

在大多数动态插入元素的场景中,推荐使用 element.insertAdjacentHTML(position, text) 代替直接修改 innerHTML。直接给父容器赋值 container.innerHTML += template 会强制销毁容器内所有的既有 DOM 节点并重新解析渲染,这会导致容器内原有的表单输入内容丢失、已绑定的事件监听器全部失效。而 insertAdjacentHTML 会将解析后的节点直接插入到指定的相对位置,完全不破坏既有元素。

标准操作步骤

  1. 定位挂载容器:使用 document.querySelector() 获取需要插入子节点的目标 DOM 元素。
  2. 构建模板字符串:使用反引号(`)定义多行 HTML 模板,利用 ${} 语法将动态字段注入到标签属性或文本节点中。
  3. 指定插入位置:依据业务布局选择合适的位置参数(通常使用 'beforeend' 追加至末尾)。
  4. 调用方法执行插入:调用 container.insertAdjacentHTML('beforeend', markup) 完成挂载。
使用JS模板字符串简化DOM元素动态创建代码示例
图 2:使用模板字符串与 insertAdjacentHTML 创建挂载 DOM 元素的执行步骤

完整代码示例

// 模拟接收到的用户对象数据
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 树中渲染,只驻留在内存中等待被克隆或提取。

使用JS模板字符串简化DOM元素动态创建代码示例
图 3:insertAdjacentHTML 的四个插入位置模型与 template 标签内存文档碎片解析机制

通用元素转换函数与事件绑定

我们可以将 <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 '&amp;';
      case '<': return '&lt;';
      case '>': return '&gt;';
      case '"': return '&quot;';
      case "'": return '&#39;';
      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}`);
});
使用JS模板字符串简化DOM元素动态创建代码示例
图 4:动态 DOM 创建方案选择决策树与关键安全性能规范

方案对比与选型参考

在面对不同开发规模与业务场景时,可以通过下表明确选择依据:

实现方式 代码可读性 性能表现 事件绑定支持 最佳适用场景
createElement + appendChild 差(随嵌套加深急剧变差) 极高(直接操作原生对象) 原生支持(每个节点都有引用) 极少复杂属性的极简节点(如单创建单个 span)
模板字符串 + insertAdjacentHTML 优(声明式结构所见即所得) 高(底层 C++ 一次性快速解析) 需结合事件委托 列表渲染、局部页面追加、绝大多数通用展示组件
模板字符串 + <template> 优(结构直观,支持组件封装) 高(惰性内存解析,无渲染重排) 支持(转换为原生 Element 后直接绑定) 弹窗、浮层、需要在插入页面前精确控制的复合组件

掌握 ES6 模板字符串与现代 DOM API 的协同使用,可以在无需引入重量级前端框架的前提下,写出优雅、结构清晰且高效的原生组件创建逻辑。在日常开发中,优先使用 insertAdjacentHTML 搭配事件委托来满足常见内容渲染,在需要对象级操作时借力 <template>,并始终贯彻 XSS 输入转义与数组 join('') 清理,就能兼顾开发效率与工程稳定性。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章