
理解 append() 方法的本质
在javascript中,element.append() 方法用于将一组 node 对象或 domstring 对象作为最后一个子元素插入到指定 element 的末尾。它的基本功能是向dom树中添加内容。然而,当操作的对象是已经存在于dom树中的节点时,append() 方法的行为可能会出乎意料,尤其是在处理表格行(
DOM元素的唯一性原则是理解这一行为的关键。在任何给定的时刻,一个DOM节点(例如一个
- 移除:首先,该节点会从其当前在DOM树中的位置被移除。
- 插入:然后,该节点被插入到 append() 方法指定的新位置。
因此,对于已存在的DOM节点,append() 方法的实际效果是“移动”该节点,而不是“复制”或“新增”一个相同的节点。
问题场景复现与分析
考虑以下HTML表格结构:
| Age | Name |
|---|---|
| 5 | John |
| 2 | Pete |
| 12 | Ann |
| 9 | Eugene |
| 1 | Ilya |
现在,假设我们尝试通过JavaScript代码将 tbody 中现有的所有行再次追加到 tbody 的末尾,期望实现行的复制:
立即学习“Java免费学习笔记(深入)”;
let tbody = grid.querySelector('tbody');
let rowsArray = Array.from(tbody.rows); // 获取所有现有行的引用
tbody.append(...rowsArray); // 尝试追加这些行预期结果:一些开发者可能会期望这段代码能将现有的表格行复制一份,并将其追加到 tbody 的末尾,从而使表格的行数翻倍。
实际结果:运行上述代码后,你会发现表格的行数并没有增加。相反,tbody 中的行只是被“移动”到了其自身的末尾。如果原始行的顺序与追加的顺序不一致,可能会导致行顺序的重新排列,但不会有新的行被创建。这是因为 tbody.rows 返回的是对现有DOM行对象的引用,rowsArray 中存储的也是这些引用。当 append() 再次接收到这些引用时,它操作的是同一个DOM元素,而非其副本。
解决方案:使用 cloneNode() 进行元素克隆
要实现元素的复制而非移动,我们需要使用 Node.cloneNode() 方法。这个方法会创建一个指定节点的副本。
cloneNode() 方法接受一个布尔值参数:
- cloneNode(true):执行深克隆。它会复制节点本身及其所有后代节点(包括文本节点、属性节点等)。
- cloneNode(false):执行浅克隆。它只复制节点本身及其所有属性,但不包括任何子节点。
为了解决上述问题,我们需要对每一行进行深克隆,然后将克隆后的新节点追加到 tbody 中。
let tbody = grid.querySelector('tbody');
// 使用 map 方法对每一行进行深克隆,生成新的DOM节点数组
let clonedRowsArray = Array.from(tbody.rows).map(row => row.cloneNode(true));
// 将克隆后的新行追加到 tbody 中
tbody.append(...clonedRowsArray);修正后的代码解释:
- Array.from(tbody.rows) 仍然获取了现有行的引用数组。
- .map(row => row.cloneNode(true)) 遍历这个引用数组,对每一行调用 cloneNode(true)。这会为每一行创建一个全新的、独立的副本(包括其内部的
单元格和文本内容)。 - clonedRowsArray 现在包含的是一组全新的DOM节点,它们与原始节点相互独立。
- tbody.append(...clonedRowsArray) 将这些全新的克隆节点作为新的子元素追加到 tbody 的末尾。
这样,表格的行数就会翻倍,并且新增加的行是原始行的精确副本,从而达到了预期的复制效果。
注意事项与最佳实践
- 性能考虑:频繁或大量地克隆复杂DOM节点可能会带来一定的性能开销。如果需要进行大量DOM操作,可以考虑使用 DocumentFragment 来批量构建DOM结构,然后一次性将其插入到文档中,以减少浏览器重绘和回流的次数。
- 事件监听器:cloneNode(true) 默认不会复制元素的事件监听器。如果原始元素上绑定了事件(例如 click 事件),克隆后的新元素将不会拥有这些事件监听器。你需要在克隆后手动为新元素重新绑定事件,或者采用事件委托(将事件监听器绑定到父元素上,通过事件冒泡处理子元素的事件)的方式来管理事件。
- ID属性:DOM元素的 id 属性在整个文档中必须是唯一的。如果克隆的元素包含 id 属性,克隆后会产生重复的 id。在克隆后,你可能需要修改克隆元素的 id 属性以保持其唯一性。
-
何时选择 append() 与 cloneNode():
- 当你希望移动一个现有元素,或者添加一个全新创建的、尚未存在于DOM中的元素时,使用 append()。
- 当你需要创建一个现有元素的完全独立副本时,使用 cloneNode()。
总结
理解DOM元素的唯一性原则是进行高效且正确DOM操作的基础。append() 方法在处理已存在的DOM节点时,其行为是“移动”而非“复制”。若要实现元素的复制功能,必须明确地使用 cloneNode() 方法来创建元素的独立副本。通过掌握这两种方法的特性及其适用场景,开发者可以更精确地控制DOM结构,避免潜在的错误,并构建出功能完善、性能优异的Web应用。










