微信号:gh_f0737a722782

介绍:SegmentFault (www.sf.gg)开发者社区,是中国年轻开发者喜爱的极客社区,我们为开发者提供最纯粹的技术交流和分享平台.

【总结】Javascript操作DOM常用API详解

2017-05-29 20:03 风雨后见彩虹

文本整理了 javascript操作 DOM的一些常用的 api,根据其作用整理成为创建,修改,查询等多种类型的 api,主要用于复习基础知识,加深对原生 js的认识。

基本概念

在讲解操作DOM的api之前,首先我们来复习一下一些基本概念,这些概念是掌握api的关键,必须理解它们。

Node类型

DOM1级定义了一个Node接口,该接口由DOM中所有节点类型实现。这个Node接口在JS中是作为Node类型实现的。在IE9以下版本无法访问到这个类型,JS中所有节点都继承自Node类型,都共享着相同的基本属性和方法。

每个节点都有一个nodeType属性,用于表明节点的类型。节点类型由在Node类型中定义的下列12个数值常量来表示,任何节点类型必居其一:

 
           
  1. Node.ELEMENT_NODE:1

  2. Node.ATTRIBUTE_NODE:2

  3. Node.TEXT_NODE:3

  4. Node.CDATA_SECTION_NODE:4

  5. Node.ENTITY_REFERENCE_NODE:5

  6. Node.ENTITY_NODE:6

  7. Node.PROCESSING_INSTRUCTION_NODE:7

  8. Node.COMMENT_NODE:8

  9. Node.DOCUMENT_NODE:9

  10. Node.DOCUMENT_TYPE_NODE:10

  11. Node.DOCUMENT_FRAGMENT_NODE:11

  12. Node.NOTATION_NODE:12

假设我们要判断一个Node是不是元素,我们可以这样判断:

 
           
  1. if(someNode.nodeType == 1){

  2.    console.log("Node is a element");

  3. }

开发人员最常用的就是元素和文本节点。

这些Node类型中,我们最常用的就是 elementtextattributecommentdocumentdocument_fragment这几种类型。 我们简单来介绍一下这几种类型:

Element类型

Element提供了对元素标签名,子节点和特性的访问,我们常用HTML元素比如div,span,a等标签就是element中的一种。Element有下面几条特性: (1)nodeType为1 (2)nodeName为元素标签名,tagName也是返回标签名 (3)nodeValue为null (4)parentNode可能是Document或Element (5)子节点可能是Element,Text,Comment,Processing_Instruction,CDATASection或EntityReference

Text类型

Text表示文本节点,它包含的是纯文本内容,不能包含html代码,但可以包含转义后的html代码。Text有下面的特性: (1)nodeType为3 (2)nodeName为#text (3)nodeValue为文本内容 (4)parentNode是一个Element (5)没有子节点

Attr类型

Attr类型表示元素的特性,相当于元素的attributes属性中的节点,它有下面的特性: (1)nodeType值为2 (2)nodeName是特性的名称 (3)nodeValue是特性的值 (4)parentNode为null

Comment类型

Comment表示HTML文档中的注释,它有下面的几种特征: (1)nodeType为8 (2)nodeName为#comment (3)nodeValue为注释的内容 (4)parentNode可能是Document或Element (5)没有子节点

Document

Document表示文档,在浏览器中,document对象是HTMLDocument的一个实例,表示整个页面,它同时也是window对象的一个属性。Document有下面的特性: (1)nodeType为9 (2)nodeName为#document (3)nodeValue为null (4)parentNode为null (5)子节点可能是一个DocumentType或Element

DocumentFragment类型

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

我们简单地介绍了几种常见的Node类型,要记住,HTML中的节点并不只是包括元素节点,它还包括文本节点,注释节点等等。在这里我们只是简单地说明了几种常见的节点,想要进一步学习的同学可以查找一下相关资料。

节点创建型api

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

createElement

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

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

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

createTextNode

createTextNode用来创建一个文本节点,用法如下:

 
           
  1. var textNode = document.createTextNode("一个TextNode");

createTextNode接收一个参数,这个参数就是文本节点中的文本,和createElement一样,创建后的文本节点也只是独立的一个节点,同样需要appendChild将其添加到HTML文档树中。

cloneNode

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

 
           
  1. var parent = document.getElementById("parentElement");

  2. var parent2 = parent.cloneNode(true);// 传入true

  3. parent2.id = "parent2";

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

我们看看这个例子:

 
           
  1. <div id="parent">

  2.    我是父元素的文本

  3.    <br/>

  4.    <span>

  5.        我是子元素

  6.    </span>

  7. </div>

  8. <button id="btnCopy">复制</button>

  9. var parent = document.getElementById("parent");

  10. document.getElementById("btnCopy").onclick = function(){

  11.    var parent2 = parent.cloneNode(true);

  12.    parent2.id = "parent2";

  13.    document.body.appendChild(parent2);

  14. }

这段代码很简单,主要是绑定button事件,事件内容是复制了一个parent,修改其id,然后添加到文档中。 这里有几点要注意:

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

除此之外,我们还有一个需要注意的点: 如果被复制的节点绑定了事件,则副本也会跟着绑定该事件吗?这里要分情况讨论: (1)如果是通过 addEventListener或者比如 onclick进行绑定事件,则副本节点不会绑定该事件 (2)如果是内联方式绑定比如:

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

这样的话,副本节点同样会触发事件。

createDocumentFragment

createDocumentFragment方法用来创建一个DocumentFragment。在前面我们说到DocumentFragment表示一种轻量级的文档,它的作用主要是存储临时的节点用来准备添加到文档中。 createDocumentFragment方法主要是用于添加大量节点到文档中时会使用到。假设要循环一组数据,然后创建多个节点添加到文档中,比如示例:

 
           
  1. <ul id="list"></ul>

  2. <input type="button" value="添加多项" id="btnAdd" />

  3. document.getElementById("btnAdd").onclick = function(){

  4.    var list = document.getElementById("list");

  5.    for(var i = 0;i < 100; i++){

  6.        var li = document.createElement("li");

  7.        li.textContent = i;

  8.        list.appendChild(li);

  9.    }

  10. }

这段代码将按钮绑定了一个事件,这个事件创建了100个li节点,然后依次将其添加HTML文档中。这样做有一个缺点:每次一创建一个新的元素,然后添加到文档树中,这个过程会造成浏览器的回流。所谓回流简单说就是指元素大小和位置会被重新计算,如果添加的元素太多,会造成性能问题。这个时候,就是使用createDocumentFragment了。 DocumentFragment不是文档树的一部分,它是保存在内存中的,所以不会造成回流问题。我们修改上面的代码如下:

 
           
  1. document.getElementById("btnAdd").onclick = function(){

  2.    var list = document.getElementById("list");    

  3.    var fragment = document.createDocumentFragment();

  4.    for(var i = 0;i < 100; i++){

  5.      var li = document.createElement("li");

  6.        li.textContent = i;

  7.        fragment.appendChild(li);

  8.    }

  9.    list.appendChild(fragment);

  10. }

优化后的代码主要是创建了一个fragment,每次生成的li节点先添加到fragment,最后一次性添加到list。

创建型API总结

创建型api主要包括createElement,createTextNode,cloneNode和createDocumentFragment四个方法,需要注意下面几点: (1)它们创建的节点只是一个孤立的节点,要通过appendChild添加到文档中 (2)cloneNode要注意如果被复制的节点是否包含子节点以及事件绑定等问题 (3)使用createDocumentFragment来解决添加大量节点时的性能问题

页面修改型API

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

appendChild

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

 
           
  1. parent.appendChild(child);

child节点将会作为parent节点的最后一个子节点。 appendChild这个方法很简单,但是还有有一点需要注意:如果被添加的节点是一个页面中存在的节点,则执行后这个节点将会添加到指定位置,其原本所在的位置将移除该节点,也就是说不会同时存在两个该节点在页面上,相当于把这个节点移动到另一个地方。我们来看例子:

 
           
  1. <div id="child">

  2.    要被添加的节点

  3. </div>

  4. <br/>

  5. <br/>

  6. <br/>

  7. <div id="parent">

  8.    要移动的位置

  9. </div>        

  10. <input id="btnMove" type="button" value="移动节点" />

  11. document.getElementById("btnMove").onclick = function(){

  12.    var child = document.getElementById("child");

  13.    document.getElementById("parent").appendChild(child);

  14. }

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

insertBefore

insertBefore用来添加一个节点到一个参照节点之前,用法如下:

 
           
  1. parentNode.insertBefore(newNode,refNode);

parentNode表示新节点被添加后的父节点 newNode表示要添加的节点 refNode表示参照节点,新节点会添加到这个节点之前 我们来看这个例子:

 
           
  1. <div id="parent">

  2.    父节点

  3.    <div id="child">                

  4.        子元素

  5.    </div>

  6. </div>

  7. <input type="button" id="insertNode" value="插入节点" />

  8. var parent = document.getElementById("parent");

  9. var child = document.getElementById("child");

  10. document.getElementById("insertNode").onclick = function(){

  11.    var newNode = document.createElement("div");

  12.    newNode.textContent = "新节点"

  13.    parent.insertBefore(newNode,child);

  14. }

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

关于第二个参数参照节点还有几个注意的地方:

(1)refNode是必传的,如果不传该参数会报错 (2)如果refNode是undefined或null,则insertBefore会将节点添加到子元素的末尾

removeChild

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

 
           
  1. var deletedChild = parent.removeChild(node);

deletedChild指向被删除节点的引用,它等于node,被删除的节点仍然存在于内存中,可以对其进行下一步操作。 注意:如果被删除的节点不是其子节点,则程序将会报错。我们可以通过下面的方式来确保可以删除:

 
           
  1. if(node.parentNode){

  2.    node.parentNode.removeChild(node);

  3. }

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

replaceChild

replaceChild用于使用一个节点替换另一个节点,用法如下:

 
           
  1. parent.replaceChild(newChild,oldChild);

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

页面修改型API总结

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

节点查询型API

节点查询型API也是非常常用的api,下面我们分别说明一下每一个api的使用。

document.getElementById

这个接口很简单,根据元素id返回元素,返回值是Element类型,如果不存在该元素,则返回null。 使用这个接口有几点要注意: (1)元素的Id是大小写敏感的,一定要写对元素的id (2)HTML文档中可能存在多个id相同的元素,则返回第一个元素 (3)只从文档中进行搜索元素,如果创建了一个元素并指定id,但并没有添加到文档中,则这个元素是不会被查找到的

document.getElementsByTagName

这个接口根据元素标签名获取元素,返回一个即时的HTMLCollection类型,什么是即时的HTMLCollection类型呢?我们来看看这个示例:

 
           
  1. <div>div1</div>

  2. <div>div2</div>

  3. <input type="button" value="显示数量" id="btnShowCount"/>

  4. <input type="button" value="新增div" id="btnAddDiv"/>    

  5. var divList = document.getElementsByTagName("div");

  6. document.getElementById("btnAddDiv").onclick = function(){

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

  8.    div.textContent ="div" + (divList.length+1);

  9.    document.body.appendChild(div);

  10. }

  11. document.getElementById("btnShowCount").onclick = function(){

  12.        alert(divList.length);

  13. }

这段代码中有两个按钮,一个按钮是显示HTMLCollection元素的个数,另一个按钮可以新增一个div标签到文档中。前面提到HTMLCollcetion元素是即时的表示该集合是随时变化的,也就是是文档中有几个div,它会随时进行变化,当我们新增一个div后,再访问HTMLCollection时,就会包含这个新增的div。

使用document.getElementsByTagName这个方法有几点要注意:

(1)如果要对HTMLCollection集合进行循环操作,最好将其长度缓存起来,因为每次循环都会去计算长度,暂时缓存起来可以提高效率 (2)如果没有存在指定的标签,该接口返回的不是null,而是一个空的HTMLCollection (3)“*”表示所有标签

document.getElementsByName

getElementsByName主要是通过指定的name属性来获取元素,它返回一个即时的NodeList对象。 使用这个接口主要要注意几点:

(1)返回对象是一个即时的NodeList,它是随时变化的 (2)在HTML元素中,并不是所有元素都有name属性,比如div是没有name属性的,但是如果强制设置div的name属性,它也是可以被查找到的 (3)在IE中,如果id设置成某个值,然后传入getElementsByName的参数值和id值一样,则这个元素是会被找到的,所以最好不好设置同样的值给id和name

document.getElementsByClassName

这个API是根据元素的class返回一个即时的HTMLCollection,用法如下:

 
           
  1. var elements = document.getElementsByClassName(names);

这个接口有下面几点要注意:

(1)返回结果是一个即时的HTMLCollection,会随时根据文档结构变化 (2)IE9以下浏览器不支持 (3)如果要获取2个以上classname,可传入多个classname,每个用空格相隔,例如:

 
           
  1. var elements = document.getElementsByClassName("test1 test2");

document.querySelector和document.querySelectorAll

这两个api很相似,通过css选择器来查找元素,注意选择器要符合CSS选择器的规则。 首先来介绍一下document.querySelector。 document.querySelector返回第一个匹配的元素,如果没有匹配的元素,则返回null。 注意,由于返回的是第一个匹配的元素,这个api使用的深度优先搜索来获取元素。我们来看这个例子:

 
           
  1. <div>

  2.    <div>

  3.        <span class="test">第三级的span</span>    

  4.    </div>

  5. </div>

  6. <div class="test">            

  7.    同级的第二个div

  8. </div>

  9. <input type="button" id="btnGet" value="获取test元素" />

  10. document.getElementById("btnGet").addEventListener("click",function(){

  11.    var element = document.querySelector(".test");

  12.    alert(element.textContent);

  13. })

这个例子很简单,就是两个class都包含“test”的元素,一个在文档树的前面,但是它在第三级,另一个在文档树的后面,但它在第一级,通过querySelector获取元素时,它通过深度优先搜索,拿到文档树前面的第三级的元素。

document.querySelectorAll的不同之处在于它返回的是所有匹配的元素,而且可以匹配多个选择符,我们来看看下面这个例子:

 
           
  1. <div class="test">

  2.    class为test

  3. </div>

  4. <div id="test">

  5.    id为test

  6. </div>

  7. <input id="btnShow" type="button" value="显示内容" />

  8. document.getElementById("btnShow").addEventListener("click",function(){

  9.    var elements = document.querySelectorAll("#test,.test");    

  10.    for(var i = 0,length = elements.length;i<length;i++){

  11.        alert(elements[i].textContent);

  12.    }    

  13. })

这段代码通过querySelectorAll,使用id选择器和class选择器选择了两个元素,并依次输出其内容。要注意两点:

(1)querySelectorAll也是通过深度优先搜索,搜索的元素顺序和选择器的顺序无关 (2)返回的是一个非即时的NodeList,也就是说结果不会随着文档树的变化而变化 兼容性问题:querySelector和querySelectorAll在ie8以下的浏览器不支持。

节点关系型api

在html文档中的每个节点之间的关系都可以看成是家谱关系,包含父子关系,兄弟关系等等,下面我们依次来看看每一种关系。

父关系型api

parentNode:每个节点都有一个parentNode属性,它表示元素的父节点。Element的父节点可能是Element,Document或DocumentFragment。

parentElement:返回元素的父元素节点,与parentNode的区别在于,其父节点必须是一个Element,如果不是,则返回null

兄弟关系型api

previousSibling:节点的前一个节点,如果该节点是第一个节点,则为null。注意有可能拿到的节点是文本节点或注释节点,与预期的不符,要进行处理一下。

previousElementSibling:返回前一个元素节点,前一个节点必须是Element,注意IE9以下浏览器不支持。

nextSibling:节点的后一个节点,如果该节点是最后一个节点,则为null。注意有可能拿到的节点是文本节点,与预期的不符,要进行处理一下。

nextElementSibling:返回后一个元素节点,后一个节点必须是Element,注意IE9以下浏览器不支持。

子关系型api

childNodes:返回一个即时的NodeList,表示元素的子节点列表,子节点可能会包含文本节点,注释节点等。 children:一个即时的HTMLCollection,子节点都是Element,IE9以下浏览器不支持。 firstChild:第一个子节点。 lastChild:最后一个子节点。 hasChildNodes方法:可以用来判断是否包含子节点。

元素属性型api

setAttribute

setAttribute:根据名称和值修改元素的特性,用法如下:

 
           
  1. element.setAttribute(name, value);

其中name是特性名,value是特性值。如果元素不包含该特性,则会创建该特性并赋值。 如果元素本身包含指定的特性名为属性,则可以世界访问属性进行赋值,比如下面两条代码是等价的:

 
           
  1. element.setAttribute("id","test");

  2. element.id = "test";

getAttribute

getAttribute返回指定的特性名相应的特性值,如果不存在,则返回null或空字符串。用法如下:

 
           
  1. var value = element.getAttribute("id");

元素样式型api

直接修改元素的样式

 
           
  1. elem.style.color = 'red';

  2. elem.style.setProperty('font-size', '16px');

  3. elem.style.removeProperty('color');

动态添加样式规则

 
           
  1. var style = document.createElement('style');

  2. style.innerHTML = 'body{color:red} #top:hover{background-color: red;color: white;}';

  3. document.head.appendChild(style);

window.getComputedStyle

通过element.sytle.xxx只能获取到内联样式,借助window.getComputedStyle可以获取应用到元素上的所有样式,IE8或更低版本不支持此方法。

 
           
  1. var style = window.getComputedStyle(element[, pseudoElt]);

element是要获取的元素,pseudoElt指定一个伪元素进行匹配。 返回的style是一个CSSStyleDeclaration对象。 通过style可以访问到元素计算后的样式

getBoundingClientRect

getBoundingClientRect用来返回元素的大小以及相对于浏览器可视窗口的位置,兼容性非常好(IE6+),用法如下:

 
           
  1. var clientRect = element.getBoundingClientRect();

clientRect是一个DOMRect对象,包含left,top,right,bottom,它是相对于可视窗口的距离,滚动位置发生改变时,它们的值是会发生变化的。除了IE9以下浏览器,还包含元素的height和width等数据,具体可查看链接

参考

转载地址:http://luopq.com/2015/11/30/javascript-dom/ 参考地址:http://blog.liuxianan.com/javascript-dom-api.html#fu-guan-xi-API


 
SegmentFault 更多文章 和少妇白洁一起学JavaScript之Async\/Await 文章 | JavaScript深入系列15篇正式完结! Android 模块化探索与实践 30分钟,让你彻底明白Promise原理 新闻 | 全球遭受大规模勒索软件攻击:涉及近100个国家!
猜您喜欢 大神Linus说要写代码到71岁,你呢? 【干货】全栈员工,你听过么 (收藏)哪些 Python 库让你相见恨晚? 社工神器《超高精确定位》-专门讲解 腾讯云推免费+降价策略,重新定义CDN价格体系