
在web开发中,我们经常需要将后端获取的数据或前端定义的数据数组展示在html表格中。手动编写每个表格行既繁琐又难以维护,因此动态生成表格内容是常见的需求。本教程将介绍一种现代且高效的方法,利用javascript的es6模板字面量(template literals)来解决这一问题。
初始问题与常见误区
在尝试动态生成表格时,开发者可能会遇到一些挑战,例如数据渲染位置不正确、HTML结构混乱或代码可读性差。一个常见的尝试是使用<template>标签配合字符串替换,如下所示:
<table id="dataTable" width="100%" cellspacing="0">
<thead>
<tr>
<th>Name</th>
<th>Title</th>
</tr>
</thead>
<tbody>
<!-- 注意:在<tbody>内放置<div>标签是不符合HTML语义的 -->
<div id="list"></div>
<template id="template">
<tr>
<td>{name}</td>
<td>{title}</td>
</tr>
</template>
</tbody>
</table>对应的JavaScript代码可能如下:
const contactArray = [{"Name":"Blake Janacek","Title":"Marketing Manager"},{"Name":"Dominic Flanders","Title":"Project Manager"}];
const html = contactArray.map(obj => {
let item = document.querySelector('#template').innerHTML;
item = item.replace('{name}', obj.Name);
item = item.replace('{title}', obj.Title);
return item;
});
document.querySelector('#list').innerHTML = html.join(''); 这种方法虽然可以工作,但存在几个问题:
- HTML语义问题: <tbody>元素内不应直接包含<div>元素,这会导致浏览器解析错误或行为异常。<tbody>内应直接是<tr>元素。
- 代码冗余: 对于每个需要替换的占位符,都需要调用一次replace方法,当字段增多时,代码会变得冗长。
- 可读性: 模板字符串与替换逻辑分离,降低了代码的直观性。
推荐方案:利用ES6模板字面量
ES6引入的模板字面量(Template Literals)提供了一种更简洁、更强大的方式来创建字符串,尤其适合动态生成HTML片段。它允许我们在字符串中直接嵌入表达式,极大地简化了字符串拼接和模板渲染。
立即学习“Java免费学习笔记(深入)”;
1. 准备HTML结构
首先,我们需要一个干净的HTML表格结构,其中<tbody>部分留空,等待JavaScript动态填充。
<table id="dataTable" width="100%" cellspacing="0">
<thead>
<tr>
<th>姓名</th>
<th>职位</th>
</tr>
</thead>
<tbody>
<!-- JavaScript将在此处动态生成<tr>元素 -->
</tbody>
</table>2. 编写JavaScript代码
接下来,我们将使用JavaScript数组和ES6模板字面量来生成表格行。
const contactArray = [
{Name:"Blake Janacek", Title:"Marketing Manager"},
{Name:"Dominic Flanders", Title:"Project Manager"},
{Name:"Alice Smith", Title:"Software Engineer"}
];
// 获取表格的tbody元素
const tableBody = document.querySelector("#dataTable tbody");
// 使用map方法遍历数组,并为每个对象生成一个<tr>字符串
const tableRows = contactArray.map(({ Name, Title }) => {
// 使用模板字面量(反引号 ` ` ` )创建字符串
// ${} 内部可以直接嵌入JavaScript表达式
return `<tr>
<td>${Name}</td>
<td>${Title}</td>
</tr>`;
});
// 将所有生成的<tr>字符串连接起来,并赋值给tbody的innerHTML
tableBody.innerHTML = tableRows.join("\n");
// 完整代码示例
/*
const contactArray = [
{Name:"Blake Janacek",Title:"Marketing Manager"},
{Name:"Dominic Flanders",Title:"Project Manager"} ];
document.querySelector("#dataTable tbody").innerHTML=
contactArray.map(({Name,Title})=>
`<tr>
<td>${Name}</td>
<td>${Title}</td>
</tr>`).join("\n");
*/代码解析:
- contactArray.map(...): map方法是数组的一个高阶函数,它会遍历数组中的每个元素,并对每个元素执行一个回调函数。回调函数的返回值将组成一个新的数组。在这里,每个回调函数都返回一个表示<tr>的字符串。
- ({ Name, Title }) => { ... }: 这是ES6的箭头函数语法,并且使用了对象解构(Object Destructuring)。它直接从contactArray中的每个对象中提取Name和Title属性,使代码更加简洁,避免了obj.Name这样的写法。
- 反引号 `: 这是模板字面量的标志。它允许字符串跨越多行,并且可以直接在其中嵌入表达式。
- ${Name} 和 ${Title}: 这是模板字面量中的占位符语法。${} 内部可以放置任何JavaScript表达式,其结果会被转换为字符串并插入到模板中。
- .join("\n"): map方法返回的是一个字符串数组(每个元素是一个<tr>字符串)。join("\n")将这些字符串连接成一个大的字符串,每个<tr>之间用换行符分隔,这有助于保持生成的HTML代码的格式整洁。
- tableBody.innerHTML = ...: 最后,将生成的完整HTML字符串赋值给<tbody>元素的innerHTML属性,浏览器会自动解析并渲染这些HTML。
优点总结
使用ES6模板字面量动态生成HTML表格具有以下显著优点:
- 简洁性与可读性: 将HTML结构和数据嵌入逻辑紧密结合,代码更易于理解和维护。
- 避免字符串拼接复杂性: 无需使用+操作符进行复杂的字符串拼接,减少了出错的可能性。
- 多行字符串支持: 反引号允许字符串跨越多行,使得HTML模板的编写更加自然和直观。
- 表达式嵌入: ${} 语法强大灵活,可以直接在模板中执行简单的JavaScript逻辑。
- 符合HTML语义: 直接将<tr>元素插入到<tbody>中,确保了表格结构的正确性。
注意事项
- 安全性: 如果您要渲染的数据来源于用户输入,请务必对数据进行HTML转义,以防止跨站脚本攻击(XSS)。直接使用innerHTML插入未经验证的用户内容是非常危险的。对于本教程中的静态数据,这不是问题。
- 性能: 对于非常大的数据集(例如数千行),频繁操作innerHTML可能会有性能开销。在这种情况下,可以考虑使用文档片段(DocumentFragment)来批量插入DOM元素,或者使用虚拟DOM库(如React, Vue)来优化渲染性能。
- 复杂模板: 对于更复杂的模板逻辑(如条件渲染、循环嵌套等),可以考虑使用专门的模板引擎(如Handlebars, EJS)或前端框架。
通过掌握ES6模板字面量,您可以更高效、更优雅地处理Web页面中的动态内容渲染,特别是在生成表格这类重复性结构时,它能极大地提升开发效率和代码质量。











