Javascript DOM操作常用API汇总

目录

1. 基本概念
2. DOM操作api分类

1. 基本概念

1.1 Node类型

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

Node.ELEMENT_NODE:1
Node.ATTRIBUTE_NODE:2
Node.TEXT_NODE:3
Node.CDATA_SECTION_NODE:4
Node.ENTITY_REFERENCE_NODE:5
Node.ENTITY_NODE:6
Node.PROCESSING_INSTRUCTION_NODE:7
Node.COMMENT_NODE:8
Node.DOCUMENT_NODE:9
Node.DOCUMENT_TYPE_NODE:10
Node.DOCUMENT_FRAGMENT_NODE:11
Node.NOTATION_NODE:12

在这12种Node类型中,我们最常用的就是element,text,attribute,comment,document,document_fragment这几种类型。下面依次进行介绍:

1.2 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。

1.3 Text类型

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

1.4 Comment类型

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

1.5 Document类型

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

1.6 DocumentFragment类型

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

2. DOM操作api分类

将DOM操作api进行分类,可分为6类:

  • 节点创造行api
  • 页面修改型api
  • 节点查询型api
  • 节点关系型api
  • 元素属性型api
  • 元素样式型api

2.1 节点创建型api

创建节点的api主要包括:createElement,createTextNode,cloneNode,createDocumentFragment。

2.1.1 createElement

createElement通过传入指定的一个标签名来创建一个元素。
示例:

let div = document.createElement("div")
document.body.appendChild(div)

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

2.1.2 createTextNode

createTextNode用来创建一个文本节点。
示例:

let textNode = document.createTextNode("一个TextNode")
let div = document.createElement("div")
div.appenChild(textNode)
document.body.appendChild(div)

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

2.1.3 cloneNode

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

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

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

<div id="parent"> 
    <span>子元素</span>
</div>
<button id="btnCopy">复制</button>
let parent = document.getElementById("parent")
let button = document.getElementById("btnCopy")

button.onclick = function(){
    var parent2 = parent.cloneNode(true)
    parent2.id = "parent2"
    document.body.appendChild(parent2)
}

示例2中,给button绑定事件,事件内容是复制了一个parent,修改其id,然后添加到文档中。
注意:
(1)和createElement一样,cloneNode创建的节点只是游离有html文档外的节点,要调用appendChild方法才能添加到文档树中。
(2)如果复制的元素有id,则其副本同样会包含该id,由于id具有唯一性,所以在复制节点后必须要修改其id。
(3)调用接收的bool参数最好传入,如果不传入该参数,不同浏览器对其默认值的处理可能不同。
如果被复制的节点绑定了事件,则副本也会跟着绑定该事件吗?这里要分情况讨论:
(1)如果是通过addEventListener或者比如onclick进行绑定事件,则副本节点不会绑定该事件。
(2)如果是内联方式绑定比如

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

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

2.1.4 createDocumentFragment

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

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

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

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

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

    list.appendChild(fragment)
}

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

2.2 页面修改型api

修改页面内容的api主要包括:appendChild,insertBefore,removeChild,replaceChild。

2.2.1 appendChild

将指定的节点添加到调用该方法的节点的子元素的末尾。
示例1:

parent.appendChild(child)

注意:
如果被添加的节点是一个页面中存在的节点,则执行后这个节点将会添加到指定位置,其原本所在的位置将移除该节点,也就是说不会同时存在两个该节点在页面上,相当于把这个节点移动到另一个地方。

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

let input = document.getElementById("btnMove")

input.onclick = function(){
    let child = document.getElementById("child")
    let parent = document.getElementById("parent")
    
    parent.appendChild(child)
}

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

2.2.2 insertBefore

insertBefore用来添加一个节点到一个参照节点之前。
示例1:

parentNode.insertBefore(newNode,refNode)

parentNode表示新节点被添加后的父节点,
newNode表示要添加的节点,
refNode表示参照节点,新节点会添加到这个节点之前。
示例2:

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

let parent = document.getElementById("parent")
let child = document.getElementById("child")
let button = document.getElementById("insertNode")

button.onclick = function(){
    let newNode = document.createElement("div")
    newNode.textContent = "新节点"
    parent.insertBefore(newNode,child)
}

这段代码创建了一个新节点,然后添加到child节点之前。和appendChild一样,如果插入的节点是页面上的节点,则会移动该节点到指定位置,并且保留其绑定的事件。
注意:
(1)refNode是必传的,如果不传该参数会报错。
(2)如果refNode是undefined或null,则insertBefore会将节点添加到子元素的末尾。

2.2.3 removeChild

removeChild顾名思义,就是删除指定的子节点并返回。
示例:

let deletedChild = parent.removeChild(node)

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

if(node.parentNode){
    node.parentNode.removeChild(node)
}

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

2.2.4 replaceChild

replaceChild用于使用一个节点替换另一个节点。
示例:

parent.replaceChild(newChild,oldChild)

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

2.3 节点查询型API

2.3.1 document.getElementById

根据元素id返回元素,返回值是Element类型,如果不存在该元素,则返回null。
示例:

<div id="child"></div>

let child = document.getElementById('child')

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

2.3.2 document.getElementsByTagName

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

<div>div1</div>
<div>div2</div>     
<input type="button" value="显示数量" id="btnShowCount"/>
<input type="button" value="新增div" id="btnAddDiv"/> 

let divList = document.getElementsByTagName("div")
let btnAddDiv = document.getElementById("btnAddDiv")
let btnShowCount = document.getElementById("btnShowCount")

btnAddDiv.onclick = function(){
    let div = document.createElement("div");
    div.textContent ="div" + (divList.length+1);
    document.body.appendChild(div);
}
    
btnShowCount.onclick = function(){
        alert(divList.length);
}

这段代码中有两个按钮,一个按钮是显示HTMLCollection元素的个数,另一个按钮可以新增一个div标签到文档中。前面提到HTMLCollcetion元素是即时的表示该集合是随时变化的,也就是是文档中有几个div,它会随时进行变化,当我们新增一个div后,再访问HTMLCollection时,就会包含这个新增的div。
注意:
(1)如果要对HTMLCollection集合进行循环操作,最好将其长度缓存起来,因为每次循环都会去计算长度,暂时缓存起来可以提高效率。
(2)如果没有存在指定的标签,该接口返回的不是null,而是一个空的HTMLCollection。
(3)“*”表示所有标签。

2.3.3 document.getElementsByName

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

2.3.4 document.getElementsByClassName

这个API是根据元素的class返回一个即时的HTMLCollection。
示例:

let elements = document.getElementsByClassName(names)

注意:
这个接口有下面几点要注意:
(1)返回结果是一个即时的HTMLCollection,会随时根据文档结构变化。
(2)IE9以下浏览器不支持。
(3)如果要获取2个以上classname,可传入多个classname,每个用空格相隔,例如
let elements = document.getElementsByClassName("test1 test2")

2.3.5 document.querySelector

此接口通过css选择器来查找元素,注意选择器要符合CSS选择器的规则。document.querySelector返回第一个匹配的元素,如果没有匹配的元素,则返回null。

2.3.6 document.querySelectorAll

document.querySelectorAll的不同之处在于它返回的是所有匹配的元素,而且可以匹配多个选择符。

2.4 节点关系型api

在html文档中的每个节点之间的关系都可以看成是家谱关系,包含父子关系,兄弟关系等。

2.4.1 父关系型api

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

2.4.2 兄弟关系型api

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

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

2.4.3 子关系型api

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

2.5 元素属性型api

2.5.1 setAttribute

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

element.setAttribute(name, value)

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

element.setAttribute("id","test")
element.id = "test"

2.5.2 getAttribute

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

let value = element.getAttribute("id")

2.6 元素样式型api

2.6.1 window.getComputedStyle

window.getComputedStyle是用来获取应用到元素后的样式,假设某个元素并未设置高度而是通过其内容将其高度撑开,这时候要获取它的高度就要用到getComputedStyle,用法如下:

let style = window.getComputedStyle(element[, pseudoElt])

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

2.6.2 getBoundingClientRect

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

let clientRect = element.getBoundingClientRect()

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

参考链接

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,928评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,192评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,468评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,186评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,295评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,374评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,403评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,186评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,610评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,906评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,075评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,755评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,393评论 3 320
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,079评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,313评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,934评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,963评论 2 351

推荐阅读更多精彩内容