# DOM编程之API学习总结篇|博客系列

> 本文系统总结了JavaScript DOM编程常用API，包括Node、Element、Text等节点类型的属性和用法，适合前端开发者快速了解和查找DOM操作方法，提升网页开发效率。

- 原文：https://feinterview.poetries.top/docs/fe-blog-docs/blog-docs/javascript/-DOM%E7%BC%96%E7%A8%8B%E4%B9%8BAPI%E5%AD%A6%E4%B9%A0%E6%80%BB%E7%BB%93%E7%AF%87
- 来源：前端进阶之旅（feinterview.poetries.top）
- 更新：2025.10.25
- 可见范围：免费部分

---

### 一、基本类型介绍

#### 1.1 Node类型

- `DOM1`级定义了一个`Node`接口，该接口由`DOM`中所有节点类型实现。这个`Node`接口在`JS`中是作为`Node`类型实现的。在`IE9`以下版本无法访问到这个类型，`JS`中所有节点都继承自`Node`类型，都共享着相同的基本属性和方法
- `Node`有一个属性`nodeType`表示`Node`的类型，它是一个整数，其数值分别表示相应的`Node`类型

![](https://s.poetries.top/cos/202204171046295.png)

![](https://s.poetries.top/cos/202204171046386.png)

- 假设我们要判断一个`Node`是不是元素，我们可以这样判断

```javascript
if(someNode.nodeType == 1){
console.log("Node is a element");
}
```

-  这些`Node`类型中，我们最常用的就是`element`，`text`，`attribute`，`comment`，`document`，`document_fragment`这几种类型

##### 1.2 Element类型
---

![](https://s.poetries.top/cos/202204171046922.png)

- `Element`提供了对元素标签名，子节点和特性的访问，我们常用`HTML`元素比如`div`，`span`，`a`等标签就是`element`中的一种。
- **`Element`有下面几条特性：**

    - `nodeType`为`1`
    - `nodeName`为元素标签名，`tagName`也是返回标签名
    - `nodeValue`为`null`
    - `parentNode`可能是`Document`或`Element`
    - 子节点可能是 `Element`，`Text`，`Comment`，`Processing_Instruction`，`CDATASection` 或 `EntityReference`

##### 1.3 Text类型
---

![](https://s.poetries.top/cos/202204171047260.png)

- `Text`表示文本节点，它包含的是纯文本内容，不能包含`html`代码，但可以包含转义后的`html`代码。`Text`有下面的特性：
    - `nodeType`为`3`
    - `nodeName`为`#text`
    - `nodeValue`为文本内容
    - `parentNode`是一个`Element`
    - 没有子节点

##### 1.4 Attr类型
---

![](https://s.poetries.top/cos/202204171047607.png)

- `Attr`类型表示元素的特性，相当于元素的`attributes`属性中的节点，它有下面的特性：
    - `nodeType`值为2
    - `nodeName`是特性的名称
    - `nodeValue`是特性的值
    - `parentNode`为`null`

##### 1.5 Comment类型
---

- `Comment`表示`HTML`文档中的注释，它有下面的几种特征：
  - `nodeType`为8
  - `nodeName`为`#comment`
  - `nodeValue`为注释的内容
  - `parentNode`可能是`Document`或`Element`
  - 没有子节点

##### 1.6 Document
---

![](https://s.poetries.top/cos/202204171046915.png)

- `Document`表示文档，在浏览器中，`document`对象是`HTMLDocument`的一个实例，表示整个页面，它同时也是`window`对象的一个属性。`Document`有下面的特性：
  - `nodeType`为`9`
  - `nodeName`为`#document`
  - `nodeValue`为 `null`
  - `parentNode`为 `null`
  - 子节点可能是一个`DocumentType`或`Element`

##### 1.7 DocumentFragment类型
---
- `DocumentFragment`是所有节点中唯一一个没有对应标记的类型，它表示一种轻量级的文档，可能当作一个临时的仓库用来保存可能会添加到文档中的节点。`DocumentFragment`有下面的特性：
  - `nodeType`为`11`
  - `nodeName`为`#document-fragment`
  - `nodeValue`为`null`
  - `parentNode`为`null`

- 我们简单地介绍了几种常见的`Node`类型，要记住，`HTML`中的节点并不只是包括元素节点，它还包括文本节点，注释节点等等。在这里我们只是简单地说明了几种常见的节点.

### 二、 DOM提供的几个属性
---
#### 2.1 childNodes属性
---
- 在一棵节点树上，`childNodes`属性可以用来获取任何一个元素的所有子节点，它是一个包含这个元素全部子元素的数组

```javascript
element.childNodes
```

#### 2.2 nodeType属性
---

- 节点之间的关系构成了节点层次，`html` 页面的可以画出一个以`html`标签为根节点的树形结构
`DOM` 会把文档看作是一棵树，同时定义了很多方法来操作这棵数中的每一个元素（节点）

```html
<html lang="en">
<head>
    <title>Document</title>
</head>
<body>
    <p>hello world!!!</p>
</body>
</html>
```

![](http://7xq6al.com1.z0.glb.clouddn.com/d7.png)

- 每一个节点都有`nodeType`属性

```javascript
node.nodeType
```
- `nodeType`属性总共有12中可能取值，但其中仅有3种有实用价值
    - 元素节点的`nodeType`属性值是1
    - 属性节点的`nodeType`属性值是2
    - 文本节点的`nodeType`属性值是3

```javascript
description.firstChild.nodeValue = text;
```

#### 2.3 nodeValue属性
---

- `nodeValue`属性
    - 如果想改变一个文本节点的值，那就使用`DOM`提供的`nodeValue`,它用来得到一个节点的值 `node.nodeValue` 
    - 需要注意：`nodeValue`属性获取对象的值时，得到的并不是包含在这个段落里的文本
    - nodeValue属性不仅可以用来检测节点的值，还可以设置节点的值

#### 2.4 firstChild和lastChild属性
---
- 数组元素`childNodes[0]`有个更直观的同义词。无论如何，只要访问`childNodes`数组的第一个元素，都可以把它写成`firstChild`

```javascript
node.firstChild
```
与下面等价

```javascript
node.childNodes[0]
```

- `DOM`还提供了一个与之对应的`lastChild`属性

```javascript
node.lastChild
```

 ### 三、节点创建型API
 ---

 - 在这里，我将常用的`DOM`操作`api`进行分类，首先要介绍的是创建型的`api`。这一类型的`api`，简而言之就是用来创建节点的

#### 3.1 createElement
---

- `createElement`通过传入指定的一个标签名来创建一个元素，如果传入的标签名是一个未知的，则会创建一个自定义的标签，注意：`IE8`以下浏览器不支持自定义标签

```javascript

var div = document.createElement("div");
```

- 使用`createElement`要注意：通过`createElement`创建的元素并不属于`html`文档，它只是创建出来，并未添加到`html`文档中，要调用`appendChild`或`insertBefore`等方法将其添加到`HTML`文档树中

#### 3.2 createTextNode
---

- `createTextNode`用来创建一个文本节点，用法如下

```javascript

var textNode = document.createTextNode("一个TextNode");
```
- `createTextNode`接收一个参数，这个参数就是文本节点中的文本，和`createElement`一样，创建后的文本节点也只是独立的一个节点，同样需要`appendChild`将其添加到`HTML`文档树中

#### 3.3 cloneNode

- `cloneNode`是用来返回调用方法的节点的一个副本，它接收一个`bool`参数，用来表示是否复制子元素，使用如下：

```javascript
var parent = document.getElementById("parentElement"); 
var parent2 = parent.cloneNode(true);// 传入true
parent2.id = "parent2";
```

- 这段代码通过`cloneNode`复制了一份`parent`元素，其中`cloneNode`的参数为`true`，表示`parent`的子节点也被复制，如果传入`false`，则表示只复制了`parent`节点

```html
<div id="parent">
    我是父元素的文本
    <br/>
    <span>
        我是子元素
    </span>
</div>
<button id="btnCopy">复制</button>

var parent = document.getElementById("parent");
document.getElementById("btnCopy").onclick = function(){
	var parent2 = parent.cloneNode(true);
	parent2.id = "parent2";
	document.body.appendChild(parent2);
}
```

- 这段代码很简单，主要是绑定`button`事件，事件内容是复制了一个`parent`，修改其`id`，然后添加到文档中

- **这里有几点要注意：**
     - 和`createElement`一样，`cloneNode`创建的节点只是游离有`html`文档外的节点，要调用`appendChild`方法才能添加到文档树中
     - 如果复制的元素有`id`，则其副本同样会包含该`id`，由于`id`具有唯一性，所以在复制节点后必须要修改其id
     - 调用接收的`bool`参数最好传入，如果不传入该参数，不同浏览器对其默认值的处理可能不同

- 除此之外，我们还有一个需要注意的点：

  - 如果被复制的节点绑定了事件，则副本也会跟着绑定该事件吗？这里要分情况讨论：
     - 如果是通过`addEventListener`或者比如`onclick`进行绑定事件，则副本节点不会绑定该事件
     - 如果是内联方式绑定比如

```html

<div onclick="showParent()"></div>

```
- 这样的话，副本节点同样会触发事件

#### 3.4 createDocumentFragment
---

- `createDocumentFragment`方法用来创建一个`DocumentFragment`。在前面我们说到`DocumentFragment`表示一种轻量级的文档，它的作用主要是存储临时的节点用来准备添加到文档中

- `createDocumentFragment`方法主要是用于添加大量节点到文档中时会使用到。假设要循环一组数据，然后创建多个节点添加到文档中

```javascript
<ul id="list"></ul>
<input type="button" value="添加多项" id="btnAdd" />

document.getElementById("btnAdd").onclick = function(){
	var list = document.getElementById("list");
	for(var i = 0;i < 100; i++){
		var li = document.createElement("li");
		li.textContent = i;
		list.appendChild(li);
	}
}
```

- 这段代码将按钮绑定了一个事件，这个事件创建了100个`li`节点，然后依次将其添加`HTML`文档中。这样做有一个缺点：每次一创建一个新的元素，然后添加到文档树中，这个过程会造成浏览器的回流。所谓回流简单说就是指元素大小和位置会被重新计算，如果添加的元素太多，会造成性能问题。这个时候，就是使用`createDocumentFragment了`

- `DocumentFragment`不是文档树的一部分，它是保存在内存中的，所以不会造成回流问题。我们修改上面的代码如下

```javascript
document.getElementById("btnAdd").onclick = function(){
	var list = document.getElementById("list");	
	var fragment = document.createDocumentFragment();

	for(var i = 0;i < 100; i++){
	  var li = document.createElement("li");
		li.textContent = i;
		fragment.appendChild(li);
	}

	list.appendChild(fragment);
}
```
- 优化后的代码主要是创建了一个`fragment`，每次生成的`li`节点先添加到`fragment`，最后一次性添加到`list`

#### 3.5 创建型API总结
---

- 创建型`api`主要包括`createElement`，`createTextNode`，`cloneNode`和`createDocumentFragment`四个方法，需要注意下面几点：

    - 它们创建的节点只是一个孤立的节点，要通过`appendChild`添加到文档中
    - `cloneNode`要注意如果被复制的节点是否包含子节点以及事件绑定等问题
    - 使用`createDocumentFragment`来解决添加大量节点时的性能问题

### 四、页面修改型API
---

- 前面我们提到创建型`api`，它们只是创建节点，并没有真正修改到页面内容，而是要调用`appendChild`来将其添加到文档树中。我在这里将这类会修改到页面内容归为一类。
修改页面内容的`api`主要包括：`appendChild`，`insertBefore`，`removeChild`，`replaceChild`

#### 4.1 appendChild
---

- `appendChild`我们在前面已经用到多次，就是将指定的节点添加到调用该方法的节点的子元素的末尾。调用方法如下：

```javascript
parent.appendChild(child);
```
- `child`节点将会作为`parent`节点的最后一个子节点

- `appendChild`这个方法很简单，但是还有有一点需要注意：如果被添加的节点是一个页面中存在的节点，则执行后这个节点将会添加到指定位置，其原本所在的位置将移除该节点，也就是说不会同时存在两个该节点在页面上，相当于把这个节点移动到另一个地方

```html
<div id="child">
    要被添加的节点
</div>
<br/>
<br/>
<br/>
<div id="parent">
    要移动的位置
</div>		
<input id="btnMove" type="button" value="移动节点" />

document.getElementById("btnMove").onclick = function(){
	var child = document.getElementById("child");
	document.getElementById("parent").appendChild(child);
}

```

- 这段代码主要是获取页面上的`child`节点，然后添加到指定位置，可以看到原本的`child`节点被移动到`parent`中了。
这里还有一个要注意的点：如果`child`绑定了事件，被移动时，它依然绑定着该事件

#### 4.2 insertBefore
---

- `insertBefore`用来添加一个节点到一个参照节点之前，用法如下

```javascript

parentNode.insertBefore(newNode,refNode);
```

- `parentNode`表示新节点被添加后的父节点
- `newNode`表示要添加的节点
- `refNode`表示参照节点，新节点会添加到这个节点之前

```html
<div id="parent">
    父节点
    <div id="child">				
        子元素
    </div>
</div>
<input type="button" id="insertNode" value="插入节点" />

var parent = document.getElementById("parent");
var child = document.getElementById("child");
document.getElementById("insertNode").onclick = function(){
	var newNode = document.createElement("div");
	newNode.textContent = "新节点"
	parent.insertBefore(newNode,child);
}
```

- 这段代码创建了一个新节点，然后添加到`child`节点之前
- 和`appendChild`一样，如果插入的节点是页面上的节点，则会移动该节点到指定位置，并且保留其绑定的事件。

- **关于第二个参数参照节点还有几个注意的地方：**
  - `refNode`是必传的，如果不传该参数会报错
  - 如果`refNode`是`undefined`或`null`，则`insertBefore`会将节点添加到子元素的末尾

#### 4.3 removeChild
---

- `removeChild`顾名思义，就是删除指定的子节点并返回，用法如下

```javascript

var deletedChild = parent.removeChild(node);

```

- `deletedChild`指向被删除节点的引用，它等于`node`，被删除的节点仍然存在于内存中，可以对其进行下一步操作。

- **注意**：如果被删除的节点不是其子节点，则程序将会报错。我们可以通过下面的方式来确保可以删除：

```javascript
if(node.parentNode){
    node.parentNode.removeChild(node);
}
```

- 通过节点自己获取节点的父节点，然后将自身删除

#### 4.4 replaceChild
---

- `replaceChild`用于使用一个节点替换另一个节点，用法如下

```javascript

parent.replaceChild(newChild,oldChild);

```
- `newChild`是替换的节点，可以是新的节点，也可以是页面上的节点，如果是页面上的节点，则其将被转移到新的位置
- `oldChild`是被替换的节点

#### 4.5 页面修改型API总结
---

- 页面修改型api主要是这四个接口，**要注意几个特点**：
     - 不管是新增还是替换节点，如果新增或替换的节点是原本存在页面上的，则其原来位置的节点将被移除，也就是说同一个节点不能存在于页面的多个位置
     - 节点本身绑定的事件会不会消失，会一直保留着

### 五、节点查询型API
---

- 节点查询型`API`也是非常常用的

#### 5.1 document.getElementById
---

---

> 以上是免费部分。完整内容需要「前端进阶之旅」会员，原文：https://feinterview.poetries.top/docs/fe-blog-docs/blog-docs/javascript/-DOM%E7%BC%96%E7%A8%8B%E4%B9%8BAPI%E5%AD%A6%E4%B9%A0%E6%80%BB%E7%BB%93%E7%AF%87
