首页 > 代码库 > 常用DOM API

常用DOM API

Node

Node是一个接口,中文叫节点,很多类型的DOM元素都是继承于它,都共享着相同的基本属性和方法。常见的Node有 element,text,attribute,comment,document 等(所以要注意 节点 和 元素 的区别,元素属于节点的一种)。

Node有一个属性 nodeType 表示Node的类型,它是一个整数,其数值分别表示相应的Node类型,具体如下:

 
  1. {  
  2.     ELEMENT_NODE: 1, // 元素节点  
  3.     ATTRIBUTE_NODE: 2, // 属性节点  
  4.     TEXT_NODE: 3, // 文本节点  
  5.     DATA_SECTION_NODE: 4,  
  6.     ENTITY_REFERENCE_NODE: 5,  
  7.     ENTITY_NODE: 6,  
  8.     PROCESSING_INSTRUCTION_NODE: 7,  
  9.     COMMENT_NODE: 8, // 注释节点  
  10.     DOCUMENT_NODE: 9, // 文档  
  11.     DOCUMENT_TYPE_NODE: 10,  
  12.     DOCUMENT_FRAGMENT_NODE: 11, // 文档碎片  
  13.     NOTATION_NODE: 12,  
  14.     DOCUMENT_POSITION_DISCONNECTED: 1,  
  15.     DOCUMENT_POSITION_PRECEDING: 2,  
  16.     DOCUMENT_POSITION_FOLLOWING: 4,  
  17.     DOCUMENT_POSITION_CONTAINS: 8,  
  18.     DOCUMENT_POSITION_CONTAINED_BY: 16,  
  19.     DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32  
  20. }  

 

 

NodeList

NodeList 对象是一个节点的集合,一般由 Node.childNodes 、 document.getElementsByName 和 document.querySelectorAll 返回的。

不过需要注意, Node.childNodes 、 document.getElementsByName 返回的 NodeList 的结果是实时的(此时跟HTMLCollection比较类似),而 document.querySelectorAll 返回的结果是固定的,这一点比较特殊。

举例如下: 

 
  1. var childNodes = document.body.childNodes;  
  2. console.log(childNodes.length); // 如果假设结果是“2”  
  3. document.body.appendChild(document.createElement(‘div‘));  
  4. console.log(childNodes.length); // 此时的输出是“3”  

 

 

HTMLCollection

HTMLCollection是一个特殊的NodeList,表示包含了若干元素(元素顺序为文档流中的顺序)的通用集合,它是实时更新的,当其所包含的元素发生改变时,它会自动更新。另外,它是一个伪数组,如果想像数组一样操作它们需要像 Array.prototype.slice.call(nodeList, 2) 这样调用。

节点查找API

  • document.getElementById :根据ID查找元素,大小写敏感,如果有多个结果,只返回第一个;

  • document.getElementsByClassName :根据类名查找元素,多个类名用空格分隔,返回一个 HTMLCollection 。注意兼容性为IE9+(含)。另外,不仅仅是document,其它元素也支持 getElementsByClassName 方法;

  • document.getElementsByTagName :根据标签查找元素, * 表示查询所有标签,返回一个 HTMLCollection 。

  • document.getElementsByName :根据元素的name属性查找,返回一个 NodeList 。

  • document.querySelector :返回单个Node,IE8+(含),如果匹配到多个结果,只返回第一个。

  • document.querySelectorAll :返回一个 NodeList ,IE8+(含)。

  • document.forms :获取当前页面所有form,返回一个 HTMLCollection ;

节点创建API

节点创建API主要包括 createElement 、 createTextNode 、 cloneNode 和 createDocumentFragment 四个方法。

createElement

创建元素: 

 
  1. var elem = document.createElement("div");  
  2. elem.id = ‘test‘;  
  3. elem.style = ‘color: red‘;  
  4. elem.innerHTML = ‘我是新创建的节点‘;  
  5. document.body.appendChild(elem);  

 

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

createTextNode

创建文本节点: 

 
  1. var node = document.createTextNode("我是文本节点");  
  2. document.body.appendChild(node);  

 

 

cloneNode

克隆一个节点: node.cloneNode(true/false) ,它接收一个bool参数,用来表示是否复制子元素。

  1. var from = document.getElementById("test");  
  2. var clone = from.cloneNode(true);  
  3. clone.id = "test2";  
  4. document.body.appendChild(clone);  

 

 

克隆节点并不会克隆事件,除非事件是用 <div onclick="test()"></div> 这种方式绑定的,用 addEventListener 和 node.onclick=xxx; 方式绑定的都不会复制。

createDocumentFragment

本方法用来创建一个 DocumentFragment ,也就是文档碎片,它表示一种轻量级的文档,主要是用来存储临时节点,大量操作DOM时用它可以大大提升性能。

假设现有一题目,要求给ul添加10000个li,我们先用最简单的拼接字符串的方式来实现:


  1. <ul id="ul"></ul>  
  2. <script>  
  3. (function()  
  4. {  
  5.     var start = Date.now();  
  6.     var str = ‘‘;  
  7.     for(var i=0; i<10000; i++)   
  8.     {  
  9.         str += ‘<li>第‘+i+‘个子节点</li>‘;  
  10.     }  
  11.     document.getElementById(‘ul‘).innerHTML = str;  
  12.     console.log(‘耗时:‘+(Date.now()-start)+‘毫秒‘); // 44毫秒  
  13. })();  
  14. </script>  

 

 

再换逐个append的方式,不用说,这种方式效率肯定低:


  1. <ul id="ul"></ul>  
  2. <script>  
  3. (function()  
  4. {  
  5.     var start = Date.now();  
  6.     var str = ‘‘, li;  
  7.     var ul = document.getElementById(‘ul‘);  
  8.     for(var i=0; i<10000; i++)  
  9.     {  
  10.         li = document.createElement(‘li‘);  
  11.         li.textContent = ‘第‘+i+‘个子节点‘;  
  12.         ul.appendChild(li);  
  13.     }  
  14.     console.log(‘耗时:‘+(Date.now()-start)+‘毫秒‘); // 82毫秒  
  15. })();  
  16. </script>  

 

 

最后再试试文档碎片的方法,可以预见的是,这种方式肯定比第二种好很多,但是应该没有第一种快:


  1. <ul id="ul"></ul>  
  2. <script>  
  3. (function()  
  4. {  
  5.     var start = Date.now();  
  6.     var str = ‘‘, li;  
  7.     var ul = document.getElementById(‘ul‘);  
  8.     var fragment = document.createDocumentFragment();  
  9.     for(var i=0; i<10000; i++)  
  10.     {  
  11.         li = document.createElement(‘li‘);  
  12.         li.textContent = ‘第‘+i+‘个子节点‘;  
  13.         fragment.appendChild(li);  
  14.     }  
  15.     ul.appendChild(fragment);  
  16.     console.log(‘耗时:‘+(Date.now()-start)+‘毫秒‘); // 63毫秒  
  17. })();  
  18. </script>  

 

 

节点修改API

节点修改API都具有下面这几个特点:

  1. 不管是新增还是替换节点,如果其原本就在页面上,那么原来位置的节点将被移除;
  2. 修改之后节点本身绑定的事件不会消失;

appendChild

这个其实前面已经多次用到了,语法就是:

parent.appendChild(child);

它会将child追加到parent的子节点的最后面。另外,如果被添加的节点是一个页面中存在的节点,则执行后这个节点将会添加到新的位置,其原本所在的位置将移除该节点,也就是说不会同时存在两个该节点在页面上,且其事件会保留。

insertBefore

将某个节点插入到另外一个节点的前面,语法:

  1. parentNode.insertBefore(newNode, refNode);  

 

这个API个人觉得设置的非常不合理,因为插入节点只需要知道newNode和refNode就可以了,parentNode是多余的,所以jQuery封装的API就比较好:

  1. newNode.insertBefore(refNode); // 如 $("p").insertBefore("#foo");  

 

 

所以切记不要把这个原生API和jQuery的API使用方法搞混了!为了加深理解,这里写一个简单的例子:


  1. <div id="parent">  
  2.     我是父节点  
  3.     <div id="child">  
  4.         我是旧的子节点  
  5.     </div>  
  6. </div>  
  7. <input type="button" id="insertNode" value=http://www.mamicode.com/"插入节点" />  
  8. <script>  
  9. var parent = document.getElementById("parent");  
  10. var child = document.getElementById("child");  
  11. document.getElementById("insertNode").addEventListener(‘click‘, function()  
  12. {  
  13.     var newNode = document.createElement("div");  
  14.     newNode.textContent = "我是新节点";  
  15.     parent.insertBefore(newNode, child);  
  16. }, false);  
  17. </script>  

 

 

关于第二个参数:

  • refNode是必传的,如果不传该参数会报错;
  • 如果refNode是undefined或null,则insertBefore会将节点添加到末尾;

removeChild

removeChild用于删除指定的子节点并返回子节点,语法:

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

 

 

deletedChild指向被删除节点的引用,它仍然存在于内存中,可以对其进行下一步操作。另外,如果被删除的节点不是其子节点,则将会报错。一般删除节点都是这么删的:

 
  1. function removeNode(node)  
  2. {  
  3.     if(!node) return;  
  4.     if(node.parentNode) node.parentNode.removeChild(node);  
  5. }  

 

 

replaceChild

replaceChild用于将一个节点替换另一个节点,语法:

 
  1. parent.replaceChild(newChild, oldChild);  

 

节点关系API

DOM中的节点相互之间存在着各种各样的关系,如父子关系,兄弟关系等。

父关系API

  • parentNode :每个节点都有一个parentNode属性,它表示元素的父节点。Element的父节点可能是Element,Document或DocumentFragment;
  • parentElement :返回元素的父元素节点,与parentNode的区别在于,其父节点必须是一个Element元素,如果不是,则返回null;

子关系API

  • children :返回一个实时的 HTMLCollection ,子节点都是Element,IE9以下浏览器不支持;
  • childNodes :返回一个实时的 NodeList ,表示元素的子节点列表,注意子节点可能包含文本节点、注释节点等;
  • firstChild :返回第一个子节点,不存在返回null,与之相对应的还有一个 firstElementChild ;
  • lastChild :返回最后一个子节点,不存在返回null,与之相对应的还有一个 lastElementChild ;

兄弟关系型API

  • previousSibling :节点的前一个节点,如果不存在则返回null。注意有可能拿到的节点是文本节点或注释节点,与预期的不符,要进行处理一下。
  • nextSibling :节点的后一个节点,如果不存在则返回null。注意有可能拿到的节点是文本节点,与预期的不符,要进行处理一下。
  • previousElementSibling :返回前一个元素节点,前一个节点必须是Element,注意IE9以下浏览器不支持。
  • nextElementSibling :返回后一个元素节点,后一个节点必须是Element,注意IE9以下浏览器不支持。

元素属性型API

setAttribute

给元素设置属性:


  1. element.setAttribute(name, value);  

 

 

其中name是特性名,value是特性值。如果元素不包含该特性,则会创建该特性并赋值。

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]);  

 

 

getBoundingClientRect

getBoundingClientRect 用来返回元素的大小以及相对于浏览器可视窗口的位置,用法如下:


  1. var clientRect = element.getBoundingClientRect();  

 

 

clientRect是一个 DOMRect 对象,包含width、height、left、top、right、bottom,它是相对于窗口顶部而不是文档顶部,滚动页面时它们的值是会发生变化的。

技术分享

来源http://blog.csdn.net/hj7jay/article/details/53389522

常用DOM API