将HTML字符转换为DOM节点并动态添加到文档中

末蓝、 2021-06-26 16:06 377阅读 0赞

将字符串动态转换为`DOM`节点，在开发中经常遇到，尤其在模板引擎中更是不可或缺的技术。

字符串转换为`DOM`节点本身并不难，本篇文章主要涉及两个主题：

1 字符串转换为`HTML DOM`节点的基本方法及性能测试

2 动态生成的`DOM`节点添加到文档中的方法及性能测试

本文的示例： 有如下代码段

<!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
        <meta http-equiv="X-UA-Compatible" content="ie=edge">
        <title>Document</title>
    </head>
    <body>
        <div id='container'>
    
        </div>
    </body>
    </html>

任务是编写一个`JavaScript`函数，接收一个文本内容，动态生成一个包含该文本的`div`，返回该`Node`。

## 1.1 动态创建`Node` ##

### 1.1.1 `innerHTML` ###

第一种方法，我们使用`document.createElement`方法创建新的元素，然后利用`innerHTML`将字符串注入进去，最后返回`firstChild`，得到动态创建的`Node`。

下面我们看第二种方法

### 1.1.2 `DOMParser` ###

`DOMParser` 实例的`parseFromString`方法可以用来直接将字符串转换为`document` 文档对象。有了`document`之后，我们就可以利用各种`DOM Api`来进行操作了。

function createDocument(txt) { 
                const template = `<div class='child'>${ txt}</div>`;
                let doc = new DOMParser().parseFromString(template, 'text/html');
                let div = doc.querySelector('.child');
                return div;
            }
            
            const container = document.getElementById('container');
            container.appendChild(createDocument('hello'));

### 1.1.2 `DocumentFragment` ###

`DocumentFragment` 对象表示一个没有父级文件的最小文档对象。它被当做一个轻量版的 `Document` 使用，用于存储已排好版的或尚未打理好格式的`XML`片段。最大的区别是因为`DocumentFragment`不是真实`DOM`树的一部分，它的变化不会引起`DOM`树的重新渲染的操作(`reflow`) ，且不会导致性能等问题。

利用`document.createRange().createContextualFragment`方法，我们可以直接将字符串转化为`DocumentFragment`对象。

function createDocumentFragment(txt) { 
                const template = `<div class='child'>${ txt}</div>`;
                let frag = document.createRange().createContextualFragment(template);
                return frag;
            }
    
            const container = document.getElementById('container');
            container.appendChild(createDocumentFragment('hello'));

这里要注意的是我们直接将生成的`DocumentFragment`对象插入到目标节点中，这会将其所有自己点插入到目标节点中，不包含自身。我们也可以使用

frag.firstChild

来获取生成的div。

### 1.1.3 性能测试 ###

下面我们来简单比对下上面三种方法的性能,只是测试生成单个节点，在实际使用中并不一定有实际意义。

先测试`createNode`。

测试100万个`Node`生成，用时 `6322`。

再来测试`createDocument`。

测试100万个`Node`生成，用时 55188。

最后来测试`createDocumentFragment`.

测试100万个`Node`生成，用时 6210。

`createDocumentFragment`方法和`createNode`方法，在这轮测试中不相上下。下面我们看看将生成的`DOM`元素动态添加到文档中的方法。

### 1.2.0 批量添加节点 ###

被动态创建出来的节点大多数情况都是要添加到文档中，显示出来的。下面我们来介绍并对比几种常用的方案。  
下面我们批量添加的方法都采用`createDocumentFragment`方法。

### 1.2.1 直接`append` ###

直接`append`方法，就是生成一个节点就添加到文档中，当然这会引起布局变化，被普遍认为是性能最差的方法。

const template = "<div class='child'>hello</div>";
    
            function createDocumentFragment() { 
                let frag = document.createRange().createContextualFragment(template);
                return frag;
            }
            // createDocumentFragment();
            const container = document.getElementById('container');
            let start = Date.now();
            for (let i = 0; i < 100000; i++) { 
                container.appendChild(createDocumentFragment());
            }
            console.log(Date.now() - start);

上面的代码我们测算动态添加10万个节点。结果如下：  
![1.png][]  
测试1000个节点耗时20毫秒，测试10000个节点耗时10001毫秒，测试100000个节点耗时46549毫秒。

### 1.2.2 `DocumentFragment` ###

上面我们已经介绍过`DocumentFragment`了，利用它转换字符串。下面我们利用该对象来作为临时容器，一次性添加多个节点。

利用`document.createDocumentFragment()`方法可以创建一个空的`DocumentFragment`对象。

const template = "<div class='child'>hello</div>";
    
            function createDocumentFragment() { 
                let frag = document.createRange().createContextualFragment(template);
                return frag;
            }
            // createDocumentFragment();
            const container = document.getElementById('container');
            let fragContainer = document.createDocumentFragment();
            let start = Date.now();
            for (let i = 0; i < 1000; i++) { 
                fragContainer.appendChild(createDocumentFragment());
            }
            container.appendChild(fragContainer);
            console.log(Date.now() - start);

测试1000个节点耗时25毫秒，10000个节点耗时2877毫秒，100000个节点浏览器卡死。

## 1.3 小结 ##

简单了介绍了几种方法，并没有什么技术含量。但是从动态添加节点来看，网上说的`DocumentFragment`方法性能远远好于直接`append`的说法在我的测试场景中并不成立。

`DocumentFragment`正确的应用场景应该是作为虚拟`DOM`容器，在频繁修改查询但是并不需要直接渲染的场景中。

[1.png]: /images/20210626/777ceb945ab5408fbac3161c83112c1e.png