文档对象模型 当你在浏览器中打开一个网页的时候,浏览器获取到页面的HTML文本并解析它,非常像我们12章的解析器。浏览器构建一个文档结构的模型,并使用这个模型在屏幕上绘画页面。
这个文档的表示就是JS在它的沙箱里可以获得的玩具之一。它是一个你可以读取或者修改的数据结构。它表现得像一个动态的数据结构:当被修改的时候看,屏幕上的页面就会更新来反映这种变化。
文档结构 你可以把HTML文档想象为一个嵌套的盒子集合。像<body></body>
包围其他的标签,这些被包围的标签返回来又包含其他标签或者文本。这有一个例子:
1 2 3 4 5 6 7 8 9 10 11 12 <!doctype html > <html > <head > <title > My home page</title > </head > <body > <h1 > My home page</h1 > <p > Hello, I am Marijn and this is my home page.</p > <p > I also wrote a book! Read it <a href ="http://eloquentjavascript.net" > here</a > .</p > </body > </html >
页面有如下结构
浏览器用于表示文档的数据结构遵循这种形状。对于每个盒子,有一个我们可以交互的对象,我们可以发现它代表的HTML标签以及包含的盒子和文本。这种表示叫做文档对象模型,或者简言之DOM。
全局绑定document
赋予我们获取这些对象的能力。documentElement
属性指的是表示<html>
标签的对象。因为每个HTML文档有一个head和一个body,它也有head和body属性,指向那些元素。
树 回想一下12章的语法树。他们的结构非常类似浏览器文档的结构。每一个节点可能引用其他的儿子节点,反过来也可能有它们的儿子节点。这种形状在嵌套的结构中很典型,元素可以包含类似于它们自己的子元素。
我们将这样的数据结构叫做树,当他有一个分支结构时,没有环路(一个节点不能包含自己,直接或间接都不行),并且有一个单一的定义良好的根。在DOM中,document.documentElement
作为根元素存在。
在计算机科学中树经常出现。除了表示如HTML文档或者程序这样的递归结构,他们经常被用于维护有序的数据集,因为元素相比在普通数组中,可以更高效的查找或者插入。
一个典型的树有不同种类的节点。egg语言的语法树有标识符,值和应用节点(application node)。应用节点可能包含儿子,而标识符和值是叶子节点,或者说是不包含儿子的节点。
DOM的元素节点也是一样,它们代表HTML标签,决定了文档的结构。这些可以有儿子节点。这样的节点的一个例子就是document.body
。这些儿子节点中的一些可能是叶子节点,如文本或者注释节点。
每一个DOM节点对象拥有一个nodeType
属性,包含一个数字代码标识节点类型。元素的代码为1,也定义在常量属性Node.ELEMENT_NODE
中。文本节点,代表文档中的一部分文本,代码为3(Node.TEXT_NODE
)。注释代码为8(Node.COMMENT_NODE
)。
另一种可视化我们文档树的方式如下:
文本节点作为叶子节点,箭头用来表明节点间的父子关系。
标准 使用神秘的数字代码标识节点类型不是像JS做的事情。本章的稍后将会看到DOM接口的其他部分同样笨重并且陌生。原因就是DOM接口不仅是为JS设计的。相反,它尽力成为一个语言中立的接口来使得自己也可以被用到其它系统——不仅是HTML也包括XML,XML是一种有着类HTML语法的通用数据格式。
这是不幸的。标准通常是有用的。但是这种情况下,优势(跨语言一致性)并不是那么引人注目的。有一个和所使用的语言恰当集成的接口要省不少时间,比起跨语言使用熟悉的接口。
作为这种不好集成的一个例子,考虑dom中元素节点的childNodes
属性。这个属性保存了一个类数组的对象,有一个length
属性和一些以数字为标签的属性用来获取子节点。但是它是NodeList
类型的一个实例,并不是一个真正的数组,所以没有slice
和map
方法。
还有一些问题仅仅是糟糕的设计。例如,没有办法创建一个新节点并立刻向上面添加儿子节点或者属性。相反,你必须首先创建它,并且使用副作用一个接一个添加儿子和属性。与DOM交互的代码很长,重复并且丑陋。
但是这些缺陷并不致命。因为JS允许我们创造自己的抽象,设计改进的方式来表达你执行的操作是可能的。浏览器编程的许多库都带有这些工具。
遍历树 DOM节点包含许多到其他临近节点的链接。如图:
即使图只展示了每种类型的一个链接,每个节点都有一个parentNode
属性指向它的父节点(如果有的话)。类似的,每个元素节点(节点类型1)有一个childNodes
属性指向一个保存它儿子节点的类数组对象。
理论上,你可以使用这些父子链接来在树中做任何移动。但是JS也给你获取一些额外的方便的链接。firstChild
和lastChild
属性指向第一个和最后一个子元素或者对于没有孩子的节点值为null。相似地,previousSibling
和nextSibling
指向邻近的节点,就是同一个父节点下的立刻出现在他们之前的节点和它们之后的节点。对于第一个儿子,previousSibling
将会为null,而对于最后一个儿子,nextSibling
为null。
还有一个children
属性,类似于childNodes
属性但是只包含元素(类型1)儿子,没有其他类型的儿子节点。当你对文本节点不感兴趣时这是有用的。
当处理类似这个的嵌套数据结构时,递归函数通常很有用。下面的函数扫描一个文档的包含给定字符串的文本节点并且当发现的时候返回true
。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 function talksAbout (node, string ) { if (node.nodeType == Node .ELEMETN_NODE ) { for (let i = 0 ; i < node.childNodes .length ; i++) { if (talksAbout (node.childNodes [i], string)) { return true ; } } return false ; } else if (node.nodeType == Node .TEXT_NODE ) { return node.nodeValue .indexOf (string) > -1 ; } } console .log (talksAbout (document .body , "book" ));
因为childNodes
不是一个真正的数组,我们不能用for/of
遍历,并且必须使用常规的for
循环或者使用Array.from
。
文本节点的nodeValue
属性保存了它表示的文本字符串。
发现元素 在这些父子兄弟之间导航这些链接很有用。但是如果我们想要在一个文档中找到特定的节点,通过在document.body
开始并且遵循一个固定的路径是错误的主意。这样做会对我们的文档结构做出假设——随后还可能会改变结构。另一个复杂的因素是即使对于节点间的空白文本节点也会创建。例子中的document的<body>
标签不仅只有三个孩子(<h1>
和两个<p>
),实际上有七个节点:这三个,加上前后的空白以及中间的空白。
所以如果我们想要在文档中获取链接的href
属性,我们不想要说类似”获取document body第六个孩子的第二个孩子”这样的话语。如果我们说“获取document中的第一个链接”更好。我们当然可以这样做。
1 2 let link = document .body .getElementsByTagName ("a" )[0 ];console .log (link.href );
所有的元素节点有一个getElementsByTagName
方法,收集所有给定标签名字的元素,直接或者间接eider那个节点的孩子并且将其作为一个类数组对象返回。
为了找到一个特定的单个节点,你可以给它一个id属性并且使用document.getElementById
来代替。
1 2 3 4 5 6 7 <p > My ostrich Gertrude:</p > <p > <img id ="gertrude" src ="img/ostrich.png" > </p > <script > let ostrich = document .getElementById ("gertrude" ); console .log (ostrich.src ); </script >
第三种相似的方法是getElementsByClassName
,类似于getElementsByTagName
,搜索元素节点的内容,并且检索所有在他们class
属性中包含给定字符串的元素。
改变document 几乎所有的关于DOM数据结构的东西可以被改变。通过改变父子关系文档树的形状可以被改变。节点有一个remove
方法来从他们当前的父节点中移除它们。为了向一个元素节点添加一个子节点,我们可以使用appendChild
,将子节点添加在孩子节点列表的末尾,或者insertBefore
,将第一个参数节点插入到第二个参数节点之前。
1 2 3 4 5 6 7 8 <p > One</p > <p > Two</p > <p > Three</p > <script > let paragraphs = document .body .getElementsByTagName ("p" ); document .body .insertBefore (paragraphs[2 ], paragraphs[0 ]); </script >
一个节点只能在文档中占据一个位置。因此,将段落3插入到段落一前面将首先从文档末尾移除它并且然后在前面插入它,导致312的顺序。所有插入结点的操作,作为一种副作用都会导致它被从当前位置移除(如果有的话)。
replaceChild
方法被用于用另一个节点替换一个孩子节点。接受一个新节点参数和另一个要被替换的节点。被替换的节点必须是方法调用的对象的孩子。注意replaceChild
和insertBefore
期望新节点是它们的第一个参数。
创造节点 假如我们想要书写一个script,来将document中所有图片标签替换成其alt属性中的文字。
这不仅涉及到移除图片,同时还要添加一个新的文本节点来替换他们。文本节点使用document.createTextNode
方法创建。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 <p > The <img src ="img/cat.png" alt ="Cat" > in the <img src ="img/hat.png" alt ="Hat" > .</p > <p > <button onclick ="replaceImages()" > Replace</button > </p > <script > function replaceImages ( ) { let images = document .body .getElementsByTagName ("img" ); for (let i = images.length - 1 ; i >= 0 ; i--) { let image = images[i]; if (image.alt ) { let text = document .createTextNode (image.alt ); image.parentNode .replaceChild (text, image); } } } </script >
给定一个字符串,createTextNode
创造一个我们可以用于插入文档的文本节点并且让他展示在屏幕上。
循环开始于列表末尾的图片。这是必须的,因为由方法类似getElementsByTagName
(或是一个类似childNodes
的属性)返回的节点列表是实时变化的。也就是随着文档变化而变化。如果我们从前面开始,移除第一个图片将会导致列表失去它的第一个元素,所以第二次循环重复的时候,i为1,循环将会停止,因为集合的长度也为1了。
如果你想要一个可靠的节点集合,对应于一个实时变化的,你可以通过调用Array.from
来转换集合到一个真正的数组。
1 2 3 4 let arrayish = {0 : "one" , 1 : "two" , length : 2 };let array = Array .from (arrayish);console .log (array.map (s => s.toUpperCase ()));
为了创建元素节点,你可以使用document.createElement
方法。这个方法接受一个标签名称并且返回一个给定类型的新的空节点。
下面的例子定义了一个实用函数elt
,创造一个元素节点,并且将剩下的参数看作是该节点的孩子节点。函数然后被用于向一个引言添加来源。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 <blockquote id ="quote" > No book can ever be finished. While working on it we learn just enough to find it immature the moment we turn away from it. </blockquote > <script > function elt (type, ...children ) { let node = document .createElement (type); for (let child of children) { if (typeof child != "string" ) node.appendChild (child); else node.appendChild (document .createTextNode (child)); } return node; } document .getElementById ("quote" ).appendChild ( elt ("footer" , "—" , elt ("strong" , "Karl Popper" ), ", preface to the second editon of " , elt ("em" , "The Open Society and Its Enemies" ), ", 1950" )); </script >
属性 一些元素属性,比如链接的href
属性,可以通过元素的DOM对象的同名属性获取。这是最常用的标准属性的情况。
但是HTML允许你设置任何你想要在节点上的属性。因为它允许我们在文档中存储额外的信息这是很有用的。如果你捏造自己的属性名,即便这样的属性不会在元素的节点上作为属性呈现。你必须使用getAttribute
和setAttribute
方法来和他们交互。
1 2 3 4 5 6 7 8 9 10 11 <p data-classified ="secret" > The launch code is 00000000.</p > <p data-classified ="unclassified" > I have two feet.</p > <script > let paras = document .body .getElementsByTagName ("p" ); for (let para of Array .from (paras)) { if (para.getAttribute ("data-classified" ) == "secret" ) { para.remove (); } } </script >
推荐在这样捏造的属性前面加上data-
前缀来确保他们不和其他任何属性冲突。
有一个常用的属性class
,是JS语言的一个关键字。由于历史原因——一些古老的JS实现不能够处理匹配关键字的属性名——用于获取这个attribute的property因此被叫做className
。你也可以用它的真名获取class
,通过使用getAttribute
和setAttribute
方法。
布局 你可能已经注意到了不同类型的元素以不同的方式布局。一些类似于p标签和标题标签的元素,占据文档的全部宽度,并且在独立的行上渲染。这些被叫做块级元素。而类似a标签和strong标签,和它们周围的文本在同一行上渲染。这样的元素叫做行内元素。
对于任何给定的文档,浏览器能够计算一个布局,基于每个元素的类型和内容给出大小和位置。这个布局然后就被用于绘画文档。
元素的大小和位置可以通过JS获取。offsetWidth
和offsetHeight
属性告诉你元素占据的像素空间。一个像素是浏览器中的度量的最基本单位。它传统上对应于屏幕可以绘画的最小的点,但是在现代浏览器上可以画非常小的点,可能就不是这样了,一个浏览器像素可能跨越多个显示点。
相似地,clientWidth
和clientHeight
给出元素内部的空间大小,忽略边框宽度。
1 2 3 4 5 6 7 8 9 <p style ="border: 3px solid red" > I'm boxed in </p > <script > let para = document .body .getElementsByTagName ("p" )[0 ]; console .log ("clientHeight:" , para.clientHeight ); console .log ("offsetHeight:" , para.offsetHeight ); </script >
找到在屏幕上的元素最准确位置的最高效的方式是getBoundingClientRect
方法。它返回一个具有top
,bottom
,left
和right
属性的对象,表明元素边缘相对于屏幕左上角的像素位置。如果想要他们相对于整个文档,你必须要添加当前的滚动位置,你可以在pageXOffset
和pageYOffset
绑定中找到。
为一个文档布局是一项繁重的工作。考虑到速度,每当你改变文档的时候,浏览器引擎会尽可能长地等待,而不会立刻重新布局。当一个改变文档的JS程序运行结束的时候,浏览器就必须计算一个新的布局来将改变的文档绘画到屏幕上。当程序通过读取类似offsetHeight
或者调用getBoundClientRect
这样的属性来获取某个东西的位置或者大小时,提供正确的信息也需要计算一个布局。
一个反复读取DOM布局信息和改变DOM的程序会强制执行大量的布局计算,并且将因此运行的非常慢。下面的代码是一个这样的例子。它包含两个不同的程序,它构建一行2000像素宽的X字符并且测量每次花费的时间。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 <p > <span id ="one" > </span > </p > <p > <span id ="two" > </span > </p > <script > function time (name, action ) { let start = Date .now (); action (); console .log (name, "took" , Date .now () - start, "ms" ); } time ("naive" , () => { let target = document .getElementById ("one" ); while (target.offsetWidth < 2000 ) { target.appendChild (document .createTextNode ("X" )); } }); time ("clever" , function ( ) { let target = document .getElementById ("two" ); target.appendChild (document .createTextNode ("XXXXX" )); let total = Math .ceil (2000 / (target.offsetWidth / 5 )); target.firstChild .nodeValue = "X" .repeat (total); }); </script >
样式 我们已经看见了不同的HTML元素可以以不同的方式绘画。一些作为块级元素显示,而另一些作为行内元素。一些添加样式,如strong使得成为粗体,a标签使得颜色变蓝并且添加下划线。
img标签展示图片的方式或者a标签在单击时做链接跳转和元素类型有关。但是我们可以改变关联到一个元素的样式,如文字颜色或者下划线。这是一个使用style
属性的例子:
1 2 <p > <a href ="." > Normal link</a > </p > <p > <a href ="." style ="color: green" > Green link</a > </p >
一个style属性可以包含一个或者多个声明,声明激素hi属性加上一个冒号和一个值。当有超过一个声明时,他们必须以分号分离。color: red; border: none
。
文档的许多方面都可以被样式影响。例如,display
属性控制元素以块级元素还是行内元素显示。
1 2 3 This text is displayed <strong > inline</strong > , <strong style ="display: block" > as a block</strong > , and<strong style ="display: none" > not at all</strong > .
block
标识使得它们自己独在一行因为块级元素不和它们周围的文本显示在一起。最后一句话没有显示,因为display:none
使得元素不在屏幕上显示。这是一种隐藏元素的新方式。相比于完全从文档中移除它们隐藏起来更好因为使得随后重新显示它们更加容易。
JS代码可以通过元素的style
属性直接修改元素的样式。这个属性保存了一个包含所有可能的样式属性的对象。这些属性值是字符串,为了改变元素的某个样式我们可以写这些属性。
1 2 3 4 5 6 7 8 9 <p id ="para" style ="color: purple" > Nice text </p > <script > let para = document .getElementById ("para" ); console .log (para.style .color ); para.style .color = "magenta" ; </script >
一些样式属性名字包含短横线,如font-family
。因为这样的属性名在JS中看上去比较笨拙,style对象中的这样的属性名就移除了短横线,并且在他们后面的单词首字母大写(style.fontFamily
)。
层叠样式 HTML的样式系统叫做CSS,也就是层叠样式表。一个样式表就是在文档中给元素添加样式的一套规则。可以在<style>
标签中给出。
1 2 3 4 5 6 7 <style > strong { font-style : italic; color : gray; } </style > <p > Now <strong > strong text</strong > is italic and gray.</p >
名字中的层叠指出多个这样的规则被组合去产生元素最终的样式。例子中,默认的<strong>
标签的样式,也就是font-weight: bold
,被在<style>
标签中的样式重写了,添加了font-style
和color
。
当多个规则应用到同一属性时,最近的读取规则获得一个高优先级并得到应用。所以如果<style>
标签中包含font-weight: normal
与默认的font-weight
规则矛盾,文本就将会是normal,而不是bold的。直接应用到节点的style
属性中的样式有最高的优先级并且总是胜出。
可以不用标签名在CSS规则中定位。.abc
应用到所有类属性中包含”abc”的元素。#xyx
应用到所有id属性包含”xyz”的元素(应该是文档中独一无二的)。
1 2 3 4 5 6 7 8 9 10 11 12 .subtle { color : gray; font-size : 80% ; } #header { background : blue; color : white; } p #main .a .b { margin-bottom : 20px ; }
优先规则只有在规则有相同的特殊性时才具有就近原则。一个规则的特殊性就是能够多精准的描述匹配元素。例如,定位p.a
要比定位p
或者.a
要精准,并且会有更高的优先级。
p > a{...}
标记应用给定样式到所有是p标签直接孩子的a标签元素。相似地,p a{..}
应用到p标签内的a标签,不管他们是不是直接孩子,抑或是间接孩子。
查询选择器 我们不会在这本书中使用太多样式表。在浏览器中编程理解他们是有帮助的,但是它们很复杂,要单独写一本书。
我介绍选择器语法的主要原因——用在样式表中决定一组样式应用到哪些元素上——是我们可以使用这种微语言作为一种高效的方式去查找DOM元素。
querySelectorAll
方法,同时定义在document
对象和元素节点,接受一个选择器字符串并返回一个包含所有匹配元素的NodeList
。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 <p > And if you go chasing <span class ="animal" > rabbits</span > </p > <p > And you know you're going to fall</p > <p > Tell 'em a <span class ="character" > hookah smoking <span class ="animal" > caterpillar</span > </span > </p > <p > Has given you the call</p > <script > function count (selector ) { return document .querySelectorAll (selector).length ; } console .log (count ("p" )); console .log (count (".animal" )); console .log (count ("p .animal" )); console .log (count ("p > .animal" )); </script >
不像如getElementsByTagName
这样的方法,由querySelectorAll
返回的对象不是实时的。当你改变文档的时候他不会改变。他也不是一个真正的数组,也可以使用Array.from
将其转换为一个数组。
querySelector
方法(没有all部分)以一种相似的方式工作。将只返回第一个匹配的元素,或者没有匹配元素时返回null。
定位和动画 position
样式属性以一种强大的方式影响布局。默认属性值为static
,意味着元素坐落在文档中的正常位置。当被设置为relative
时,元素仍然在文档中占据空间,但是现在top
和left
样式属性可被用于相对于正常的位置移动他。当position
被设置为absolute
时,元素被从正常的文档流中移除——那就是说,他不在占据空间并且可能被其他元素覆盖。同时,它的top
和left
属性可用于相对最近的position
属性不是static
的外部元素的左上角来绝对定位,或者如果没有这样的元素时,相对文档来定位。
我们可以利用这个来创造动画。下面的文档显示了一个猫的图片,以椭圆轨迹来回移动。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 <p style="text-align: center" > <img src ="img/cat.png" style ="position: relative" > </p > <script > let cat = document .querySelector ("img" ); let angle = Math .PI / 2 ; function animate (time, lastTime ) { if (lastTime != null ) { angle += (time - lastTime) * 0.001 ; } cat.style .top = (Math .sin (angle) * 20 ) + "px" ; cat.style .left = (Math .cos (angle) * 200 ) + "px" ; requestAnimationFrame (newTime => animate (newTime, time)); } requestAnimationFrame (animate); </script >
我们的图片在页面居中并且position
为relative
。我们将重复改变图片的top
和left
样式来移动它。
该script使用requestAnimationFrame
,每当浏览器准备重绘屏幕的时候调度animate
函数去运行。animate
函数本身再次调用requestAnimationFrame
来调度下次升级。当浏览器窗口(或标签页)激活的时候,这将导致变化以每秒60帧做升级,这将产生一个好看的动画。
如果我们只是在循环中改变DOM,页面将会冻结,并且什么也不会展示在屏幕上。当JS程序运行的时候浏览器不会改变它们的显示,它们也不允许和页面产生任何交互。这就是为什么我们需要requestAnimationFrame
——它让浏览器知道我们现在做完了,他可以继续做浏览器做的事情,如升级画面,响应用户行为。
当前时间作为一个参数传进动画函数。为了确保猫每毫秒的稳定运动,它基于当前时间和上次函数运行的时间差确定角度变化的速度。如果仅仅是每一步移动一个固定的角度,如果在同一台计算机上运行的另一个繁重任务是阻止函数运行几分之一秒,那么这个函数就会断断续续。
以圆移动通过三角函数Math.cos
和Math.sin
实现的。对于那些不熟悉他们的人,我将简要介绍他们,因为我们偶尔会在这本书中用到。
Math.cos
和Math.sin
对于找到半径为1的圆心在0,0的圆上的点是有用的。这两个函数将他们的参数作为在圆上的位置来解释,0表示在圆的最右边,顺时针走一圈就是2pi。Math.cos
告诉你对应给定位置的点的x坐标,Math.sin
对应y坐标。大于2pi或者小于0的位置(或角度)是合法的。a+2pi和a指的是同样的角度。
这种量度角度的单位叫做弧度——满圆就是2pi弧度,相似于角度制的360°。常数pi可通过Math.PI
在JS中读取。
猫的动画代码维护了一个计数器,angle
来记录当前动画的角度,并在每次调用animate
函数的时候增加。可以随后使用这个角度来计算当前图片元素的位置。top
样式通过Math.sin
就算并且乘以20,是我们椭圆的垂直半径。left
样式基于Math.cos
并且乘以了200,让这个椭圆看上去宽一点。
注意样式通常需要单位。在这个例子中,我们在数字后面添加”px”告诉浏览器我们以像素计数(对应厘米,”ems”或者其他单位)。这很容易忘记。使用不带单位的数字将会使得你的样式被忽略——除非数字是0。
总结 JS程序可以通过一个叫做DOM的数据结构和浏览器显示的文档交互。这个数据结构代表了浏览器对这个文档建立的模型,并且JS可以通过修改它来改变显示的文档。
DOM组织得像个树,妻子红的元素根据文档结构有层次低被安排。表示元素的对象由如parentNode
和childNodes
这样的属性,可被用于在在树中导航。
文档显示的方式可被通过样式来影响,可以通过直接关联样式到节点上,也可以为匹配的节点定义规则。有许多样式属性,如color和display。JS代码可以直接通过它的style属性来修改元素的样式。