NodeList 接口
NodeList 接口
节点都是单个对象,有时需要一种数据结构,能够容纳多个节点。DOM 提供两种节点集合,用于容纳多个节点:NodeList
和HTMLCollection
。
这两种集合都属于接口规范。许多 DOM 属性和方法,返回的结果是NodeList
实例或HTMLCollection
实例.
1.概述
NodeList
实例是一个类似数组的对象,它的成员是节点对象。通过以下方法可以得到NodeList
实例。
Node.childNodes
-
document.querySelectorAll()
、document.getElementsByTagName()
等节点搜索方法
document.body.childNodes instanceof NodeList // true
NodeList
实例很像数组,可以使用length
属性和forEach
方法。但是,它不是数组,不能使用pop
或push
之类数组特有的方法。
var children = document.body.childNodes;
Array.isArray(children) // false
children.length // 34
children.forEach(console.log)
上面代码中,NodeList 实例children
不是数组,但是具有length
属性和forEach
方法。
如果NodeList
实例要使用数组方法,可以将其转为真正的数组。
var children = document.body.childNodes;
var nodeArr = Array.prototype.slice.call(children);
除了使用forEach
方法遍历 NodeList 实例,还可以使用for
循环。
var children = document.body.childNodes;
for (var i = 0; i < children.length; i++) {
var item = children[i];
}
注意,NodeList 实例可能是动态集合,也可能是静态集合。所谓动态集合就是一个活的集合,DOM 删除或新增一个相关节点,都会立刻反映在 NodeList 实例。目前,只有Node.childNodes
返回的是一个动态集合,其他的 NodeList 都是静态集合。
var children = document.body.childNodes;
children.length // 18
document.body.appendChild(document.createElement('p'));
children.length // 19
上面代码中,文档增加一个子节点,NodeList 实例children
的length
属性就增加了1。
4.2 NodeList.prototype.length
length
属性返回 NodeList 实例包含的节点数量。
document.getElementsByTagName('xxx').length
// 0
上面代码中,document.getElementsByTagName
返回一个 NodeList 集合。对于那些不存在的 HTML 标签,length
属性返回0
。
4.3 NodeList.prototype.forEach()
forEach方法用于遍历 NodeList 的所有成员。它接受一个回调函数作为参数,每一轮遍历就执行一次这个回调函数,用法与数组实例的forEach方法完全一致。
var children = document.body.childNodes;
children.forEach(function f(item, i, list) {
// ...
}, this);
上面代码中,回调函数f
的三个参数依次是当前成员、位置和当前 NodeList 实例。forEach
方法的第二个参数,用于绑定回调函数内部的this
,该参数可省略。
4.4 NodeList.prototype.item()
item
方法接受一个整数值作为参数,表示成员的位置,返回该位置上的成员。
document.body.childNodes.item(0)
上面代码中,item(0)
返回第一个成员。
如果参数值大于实际长度,或者索引不合法(比如负数),item
方法返回null
。如果省略参数,item
方法会报错。
所有类似数组的对象,都可以使用方括号运算符取出成员。一般情况下,都是使用方括号运算符,而不使用item
方法。
document.body.childNodes[0]
4.5 NodeList.prototype.keys(),NodeList.prototype.values(),NodeList.prototype.entries()
这三个方法都返回一个 ES6 的遍历器对象,可以通过for...of
循环遍历获取每一个成员的信息。区别在于,keys()
返回键名的遍历器,values()
返回键值的遍历器,entries()
返回的遍历器同时包含键名和键值的信息。
var children = document.body.childNodes;
for (var key of children.keys()) {
console.log(key);
}
// 0
// 1
// 2
// ...
for (var value of children.values()) {
console.log(value);
}
// #text
// <script>
// ...
for (var entry of children.entries()) {
console.log(entry);
}
// Array [ 0, #text ]
// Array [ 1, <script> ]
// ...
HTMLCollection 接口
5.1 概述
HTMLCollection
是一个节点对象的集合,只能包含元素节点(element),不能包含其他类型的节点。它的返回值是一个类似数组的对象,但是与NodeList
接口不同,HTMLCollection
没有forEach
方法,只能使用for
循环遍历。
返回HTMLCollection实例的,主要是一些Document对象的集合属性,比如document.links、docuement.forms、document.images等。
document.links instanceof HTMLCollection // true
HTMLCollection
实例都是动态集合,节点的变化会实时反映在集合中。
如果元素节点有id
或name
属性,那么HTMLCollection
实例上面,可以使用id
属性或name
属性引用该节点元素。如果没有对应的节点,则返回null
。
// HTML 代码如下
// <img id="pic" src="http://example.com/foo.jpg">
var pic = document.getElementById('pic');
document.images.pic === pic // true
上面代码中,document.images
是一个HTMLCollection
实例,可以通过<img>
元素的id
属性值,从HTMLCollection
实例上取到这个元素。
5.2 HTMLCollection.prototype.length
length属性返回HTMLCollection实例包含的成员数量。
document.links.length // 18
5.3 HTMLCollection.prototype.item()
item
方法接受一个整数值作为参数,表示成员的位置,返回该位置上的成员。
var c = document.images;
var img0 = c.item(0);
上面代码中,item(0)
表示返回0号位置的成员。由于方括号运算符也具有同样作用,而且使用更方便,所以一般情况下,总是使用方括号运算符。
如果参数值超出成员数量或者不合法(比如小于0),那么item
方法返回null
。
5.4 HTMLCollection.prototype.namedItem()
namedItem
方法的参数是一个字符串,表示id
属性或name
属性的值,返回对应的元素节点。如果没有对应的节点,则返回null
。
// HTML 代码如下
// <img id="pic" src="http://example.com/foo.jpg">
var pic = document.getElementById('pic');
document.images.namedItem('pic') === pic // true
ParentNode 接口
节点对象除了继承 Node 接口以外,还会继承其他接口。ParentNode
接口表示当前节点是一个父节点,提供一些处理子节点的方法。ChildNode
接口表示当前节点是一个子节点,提供一些相关方法。
如果当前节点是父节点,就会继承ParentNode
接口。由于只有元素节点(element)、文档节点(document)和文档片段节点(documentFragment)拥有子节点,因此只有这三类节点会继承ParentNode
接口。
6.1 ParentNode.children
children
属性返回一个HTMLCollection
实例,成员是当前节点的所有元素子节点。该属性只读。
下面是遍历某个节点的所有元素子节点的示例。
for (var i = 0; i < el.children.length; i++) {
// ...
}
注意,
children
属性只包括元素子节点,不包括其他类型的子节点(比如文本子节点)。如果没有元素类型的子节点,返回值HTMLCollection
实例的length
属性为0
。
另外,HTMLCollection
是动态集合,会实时反映 DOM 的任何变化。
6.2 ParentNode.firstElementChild
firstElementChild属性返回当前节点的第一个元素子节点。如果没有任何元素子节点,则返回null。
document.firstElementChild.nodeName
// "HTML"
6.3 ParentNode.lastElementChild
lastElementChild
属性返回当前节点的最后一个元素子节点,如果不存在任何元素子节点,则返回null
。
document.lastElementChild.nodeName
// "HTML"
上面代码中,document
节点的最后一个元素子节点是<HTML>
(因为document
只包含这一个元素子节点)。
6.4 ParentNode.childElementCount
childElementCount
属性返回一个整数,表示当前节点的所有元素子节点的数目。如果不包含任何元素子节点,则返回0
。
document.body.childElementCount // 13
6.5 ParentNode.append(),ParentNode.prepend()
append
方法为当前节点追加一个或多个子节点,位置是最后一个元素子节点的后面。
该方法不仅可以添加元素子节点,还可以添加文本子节点。
var parent = document.body;
// 添加元素子节点
var p = document.createElement('p');
parent.append(p);
// 添加文本子节点
parent.append('Hello');
// 添加多个元素子节点
var p1 = document.createElement('p');
var p2 = document.createElement('p');
parent.append(p1, p2);
// 添加元素子节点和文本子节点
var p = document.createElement('p');
parent.append('Hello', p);
注意,该方法没有返回值.
prepend
方法为当前节点追加一个或多个子节点,位置是第一个元素子节点的前面。它的用法与append
方法完全一致,也是没有返回值。
ChildNode 接口
如果一个节点有父节点,那么该节点就继承了ChildNode
接口。
7.1 ChildNode.remove()
remove
方法用于从父节点移除当前节点。
el.remove()
上面代码在 DOM 里面移除了el
节点。
7.2 ChildNode.before(),ChildNode.after()
before
方法用于在当前节点的前面,插入一个或多个同级节点。两者拥有相同的父节点。
注意,该方法不仅可以插入元素节点,还可以插入文本节点。
var p = document.createElement('p');
var p1 = document.createElement('p');
// 插入元素节点
el.before(p);
// 插入文本节点
el.before('Hello');
// 插入多个元素节点
el.before(p, p1);
// 插入元素节点和文本节点
el.before(p, 'Hello');
after
方法用于在当前节点的后面,插入一个或多个同级节点,两者拥有相同的父节点。用法与before
方法完全相同。
7.3 ChildNode.replaceWith()
replaceWith
方法使用参数节点,替换当前节点。参数可以是元素节点,也可以是文本节点。
var span = document.createElement('span');
el.replaceWith(span);
上面代码中,el
节点将被span
节点替换。