前言

Document 接口表示任何在浏览器中载入的网页,并作为网页内容的入口,也就是DOM 树。
描述了任何类型的文档的通用属性与方法。
根据不同的文档类型(例如HTML、XML、SVG,…),还能使用更多 API:使用 “text/html” 作为内容类型(content type)的 HTML 文档,
还实现了 HTMLDocument 接口,而 XML 和 SVG 文档则(额外)实现了 XMLDocument 接口。

零、Document与DOM文档对象模型

1、DOM文档对象模型

DOM 树包含了像 <body><table> 这样的元素,以及大量其他元素。
它向网页文档本身提供了全局操作功能,能解决如何获取页面的 URL ,如何在文档中创建一个新的元素这样的问题。
DOM模型用一个逻辑树来表示一个文档,树的每个分支的终点都是一个节点(node),每个节点都包含着对象(objects)。
DOM的方法(methods)让你可以用特定方式操作这个树,用这些方法你可以改变文档的结构、样式或者内容。
节点可以关联上事件处理器,一旦某一事件被触发了,那些事件处理器就会被执行。

比如下面的一个对应解析树结果

1
2
3
4
5
6
7
8
9
10
<html>
<head>
<title>Sample Document</title>
</head>
<body>
<!-- 以下是一个注释节点 -->
<h1>An Html Document</h1>
<p>This is a <i>Simple</i> document</p>
</body>
</html>

🤔根据上述代码,生成的对应的html的节点树的结构如下:
Document
任何的一个html节点,均会被渲染为一个以Document为起点的节点树。在浏览器中,一般根据document对象来对Dom树以及节点进行操作的。
⚠️ DOM 将文档解析为一个由节点和对象(包含属性和方法的对象)组成的结构集合。

2、Document对象接口

document与DOM之间的关系,可以用以下一个等式来表示:

API (web 或 XML 页面) = DOM + JS (脚本语言)

Document的继承关系

0.2.1、document的属性一览

document接口表示任何在浏览器中载入的网页,向网页文档本身提供了全局操作功能,能解决如何获取页面的 URL ,如何在文档中创建一个新的元素这样的问题

Node与HTMLXXX

🤔 HTMLElement与Element的区别:前者代表的是具体对应的某个Html元素,HTMLElement集成与Element,比如要使用img节点的src属性,那么我们需要在HTMLImageElement中获取到
对应的src属性,该属性从HTMLImageElement中继承而来,一般用Image()函数将会创建一个新的HTMLImageElement实例,它的作用是与document.createElement(‘img’)的功能是一致的!

👉 因此,需要了解这个HTMLElement中的属性都有哪些

一、对节点元素的选取

1.1 Node节点家族

既然可以生成一html节点树,那么我们想要操作到每一个节点的话,应当如何来操作到对应的节点呢?
需要有统一的一个方案,来操作到整棵树以及树上的每一个节点,如下图:
要理解DOM节点是如何组织以及管理整棵树的,需要先了解到其中的关于DOM、Node、以及其他所有节点的一个继承、组织关系
Node及其后代节点组织结构

按照以前的编码思维,我们经常使用的节点一般是:Document、Element、Attr,其他的比较少涉及到,现在针对这上述的所有孩子节点,这边进行一个学习知识的整理

1.1.1、Document

文档接口表示整个HTML或XML文档。从概念上讲,它是文档树的根,并提供对文档数据的主要访问。
由于元素、文本节点、注释、处理说明等不能存在于文档的上下文之外,因此文档界面还包含创建这些对象所需的工厂方法。
创建的节点对象具有ownerDocument属性,该属性将它们与在其上下文中创建它们的文档相关联。
Document对象

1.1.2、DocumentFragment

DocumentFragment是“轻量级”还是“最小”Document对象。希望能够提取文档树的一部分或创建文档的新片段是非常常见的。
想象一下,通过移动片段来实现一个用户命令,比如剪切或重新排列文档。希望有一个可以保存这些片段的对象,为此使用节点是很自然的。
但事实上Document对象可以扮演这个角色,一个Document对象可能是一个重量级对象,具体取决于底层实现。真正需要的是一个非常轻量级的对象。
DocumentFragment就是这样一个对象,一般我们如果直接针对document中的节点进行的任何操作,都会立刻让节点在每次操作中重新发起渲染动作;

1.1.3、DocumentType

每个Document有一个 文档类型其值为null或者 文档类型对象。
DocumentType

1.1.4、EntityReference(只读属性,后续浏览器不兼容)
1.1.5、Element

文档中的所有节点都是Element节点表示,自从Element接口继承自Node,通用的Node接口方法 获取属性可用于检索元素的所有属性集
Element
对上述图片中的部分方法的解析:

var attrNode = element.getAttributeNode(attrName);

  • 根据提供的字符串属性名称,返回指定元素的指定属性节点
  • attrNode 获得的属性返回值,是Attr节点,nodeType 为 2
  • attrName 是一个包含属性名称的 字符串

element.normalize();

  • Node.normalize() 方法将当前节点和它的后代节点”规范化“(normalized)。在一个”规范化”后的DOM树中,不存在一个空的文本节点,或者两个相邻的文本节点。
  • 注1:“空的文本节点”并不包括空白字符(空格,换行等)构成的文本节点。
  • 注2:两个以上相邻文本节点的产生原因包括:
    • 通过脚本调用有关的DOM接口进行了文本节点的插入和分割等。
    • HTML中超长的文本节点会被浏览器自动分割为多个相邻文本节点。
      比如有以下的一个例子
      1
      2
      3
      4
      5
      6
      7
      8
      9
      var wrapper = document.createElement("div");
      wrapper.appendChild(document.createTextNode("Part 1 "));
      wrapper.appendChild(document.createTextNode("Part 2 "));
      // 这时(规范化之前),wrapper.childNodes.length === 2
      // wrapper.childNodes[0].textContent === "Part 1 "
      // wrapper.childNodes[1].textContent === "Part 2 "
      wrapper.normalize();
      // 现在(规范化之后), wrapper.childNodes.length === 1
      // wrapper.childNodes[0].textContent === "Part 1 Part 2"
1.1.6、Attr

Attr继承关系

Attr 节点继承自Node,但不被认为是文档树的一部分。Node上定义的常用属性,如 parentNode, previousSibling, 和 nextSibling
对于 Attr节点来说都为null。然而,你可以使用 ownerElement 来得到拥有这个属性的元素。
Attr
针对上述属性的解析:

  • name 返回属性的名称
  • specified 返回是否已经定义该属性的值的标识
  • value 返回属性的值
1.1.7、Comment

Comment 代表标签(markup)之间的文本符号(textual notations),也就是Html注释
Comment继承关系
该接口没有特定的方法,但从其父类 CharacterData 继承方法,以及间接从 Node 继承部分方法。

1.1.8、CharacterData

CharacterData 抽象接口(abstract interface)代表 Node 对象包含的字符。这是一个抽象接口,意味着没有 CharacterData 类型的对象。
它是在其他接口中被实现的,如 Text、Comment 或 ProcessingInstruction 这些非抽象接口。
该接口对象中的属性/方法有:
CharacterData

1.1.9、Entity

HTML 实体是一段以连字号(&)开头、以分号(;)结尾的文本(字符串)。
Entity

1.1.10、Notation

从上述的Node的一个组织结构,我们可以不难看出浏览器其实是采用的组织树的方式来进行对文档整体的渲染,将普通的html文本内容,直接渲染成为一棵树的,
而其后代节点由于继承了Node对象,可以直接使用Node对象中的属性以及方法。
以下提供关于Node节点所提供的属性+api,可供上述任何一个孩子节点直接使用,从而来操作到整棵节点树。
Node一览

1.2、Node节点的属性

HTMLElement的继承关系

HTMLElement从多个”基类”对象中继承而来,因此可以利用”基类”对象所提供的属性+方法来服务于自身。

HTMLElement属性一览

表示HTML文档元素的HTMLElement对象定义了读/写属性,映射了元素的HTML属性,HTMLElement定义了通用HTTP属性,以及事件处理程序属性,而其特定的Element
子类型为其对应元素定义了特定的属性。比如要使用img的src属性,则是利用的HTMLElement中的src属性,因此需要了解
HTMLElement中的属性都有哪些?

✨HTMLElement中的属性:
写在html标签上的属性都属于HTMLElement的属性,可通过js对属性进行访问,都使用小写单词来表示,若是js中的关键词,比如for,则用el.htmlFor来表示,
若是中横线,比如tab-index,则使用ele.tabIndex。进阶用法:HTMLElement提供了一个数据集属性,以data-开头,定义在HTMLElement额外的属性中,这
种方法便是最原始的操作节点上的数据方法。

1.3、元素的内容

123

✨关于innerHtml属性
ele.innerHtml的赋值很有执行效率,一旦发生赋值动作,浏览器立刻执行解析渲染动作,因此这里一般是在完成整体字符串的拼接之后,才去对整个字符串进行innerHtml赋值
这样子能够确保在只是目标结果之前,页面计划仅会发生一次解析渲染操作。

✨关于outHtml属性
可以将原始的p节点进行整个的替换,包括标签

✨关于insertAdjacentHTML()方法
将任意的HTML标记字符串插入到执行的元素”相邻”的位置,使用方式如下:

1
ele.insertAdjacentHTML(insertPosition, html);

上述调用中insertPosition是一枚举值:beforebegin、afterBegin、beforeend、afterend其中的一个枚举值,代表将html字符串插入到ele指定的位置上
insertAdjacentHTML

✨关于textContent属性
textContent属性,就是将指定元素的所有后代Text节点简单的串联在一起

1.4、创建、插入和删除元素

Document操作节点
通过Document来创建一个个的节点Node,然后每个节点都有自身的增、删、查、改操作,来完成各自节点的新增或者插入、删除操作,从而达到修改整棵树的目的。
上述创建出来的节点中有一个比较特殊的节点:DocumentFragment,其parentNode总为null,类似于Node节点,它可以拥有子节点,允许增、删、查、改操作,
有点类似于安卓中的Fragment部件,将一个个页面拆分为不同的fragment,然后对每个fragment进行各自的维护,一个没有父节点的最小文档对象,与标准的Document
类似,但不是document的一部分,其变化不会出发DOM的重新解析渲染,因此也不会导致性能问题,一般的使用方式是将整个DocumentFragment作为一个子树给完善好,
然后将整个Document作为一整个节点,插入到其他某个节点元素上,完成一次性渲染动作。

✨template标签:内容模版元素,用于保护客户端内容的机制,该内容在加载页面的时候,不会呈现出来,但随后可以在运行时使用javascript实例化,这里留下一个思考:
对于vue、模版渲染引擎比如art-template等框架的是如何将template给渲染为实际的页面控件的?

二、元素的外观(尺寸与位置、与滚动)

WEB应用程序可以将文档看成是元素的树,在完成布局之后,怎样才能在抽象的基于树的文档模型与几何形状的基于坐标的视图之间来回切换呢?

2.1、文档

WEB应用程序所渲染出来的整个界面,一般都有宽度 + 高度

2.2、视口

视口,只是实际现实文档内容的浏览器的一部分,它不是包括浏览器的外壳。
当有iframe嵌套的时候,就是从iframe左上角至右下角的整个区域;
当没有iframe嵌套的时候,就是显示器中展示的扣除标题栏、状态栏、工具栏之后的其他剩余肉眼可见的其他部分;

2.3、文档与视口的联系

关于滚动条的出现:

  • 文档宽度/高度 > 视口宽度/高度:出现滚动条
  • 文档宽度/高度 < 视口宽度/高度:不出现滚动条

这里的差值,也就是滚动条的滚动距离scrollOffset,那么我们就可以利用整个滚动距离来换算文档与视口之间的关系。
在现代浏览器中通过document.body.scrollLeft或者document.body.scrollTop就可以获取到浏览器滚动的滚动距离

一般来说,文档的坐标不会改变,但视口坐标,会因为滚动条的滚动,导致元素在视口中的位置发生改变,这一点非常重要,从而可以解释文档与视口的真实联系。

2.4、尺寸与位置

在现代浏览器中,我们可以用document.body.clientWidth以及document.body.clientHeight的方式,来获取一个视口的宽高。

既然浏览器自身有查询滚动位置+自身宽高,那么对于元素而言,是否也有这样子的一个机制来查询元素的位置以及尺寸大小呢?

getBoundingClientRect,返回一个包含left、right、top、bottom、width、height的对象,left和top表示该元素的左上角的X和Y坐标,这个方法返回的是当前元素在
视口中位置

根据上述所描述的文档与视口之间的关系,在获取到一个元素的视口位置了之后,我们如果需要获取该元素在文档中的位置的话,就需要借助于滚动距离了,具体如下:

1
2
3
4
var box = ele.getBoundingClientRect();  // 获取元素在视口坐标中的位置
var scrollOffset = {x: document.body.scrollLeft, y: document.body.scrollTop}; // 这里假定是在文档中滚动
var x = box.left+scrollOffset.x;
var y = box.top+scrollOffset.y;

⚠️ ele.getBoundingClientRect获取的是一个块级元素的Rect区域的,如果ele是一个内联元素,比如是span/i标签的话,在没有额外用css进行加以控制的情况下,
这个时候使用getBoundingClientRect的话,将会返回的Rect区域,将会包含是两行的宽度/高度,如果想要查询内联元素的话,可以是使用getClientRects()来获取
整个集合,然后在遍历集合中的每个元素,进行返回。

⚠️ ele.getBoundingClientRect调用的是静态快照的方式,也就是说是在视口坐标中的静态快照,当用户滚动或者缩放浏览器的时候,并不会改变getBoundingClientRect
所返回的结果值。

2.5、实际测量方案

2.5.1、window提供的滚动方法
  • scrollTo:滚动到指定的点为视口的左上角
  • scroll: 同scrollTo
  • scrollBy:于上述两者相类似,但其参数是相对的,并在当前滚动条的偏移量上增加

⚠️ ele.scrollIntoView:与window.location.hash的命名锚点类似,将一个元素至于可视化的位置的原点,但整个node的api有一个致命性的问题,就是让父容器
也有滚动条的时候,就无法会跟随着将父容器的滚动条也至与原点。

2.5.2、关于元素尺寸、位置、溢出探讨

任何Html元素的只读属性offsetWidth和offsetHeight属性,以css像素返回它的屏幕尺寸,这种返回的尺寸包含元素的边框和内边距,去除的外边距,这是一种文档坐标,
但是对于已经fixed的父节点/祖先节点,其孩子节点通过offsetWidth/offsetHeight获取到的是相对于父节点/祖先节点的位置坐标

✨offsetParent指的是offsetTop/offsetLeft所相对的父元素

一般来说,获取一个元素e的位置时,需要一个循环计算,不断累加并遍历其父元素

✨所有的HTMLElement都定义了一下的属性
HTMLElement关于位置与尺寸属性一览

通过上述这里的对比,我们可以知道三者之间的一个区别,以及在实际的应用中,应当如何选择对应的属性来服务于界面的开发。

👉 一般地,我们可以将元素充当视口,元素的内容可以超过视口,使用css属性overflow: scroll,记可以看到元素内滚动区域效果,这里需要限定元素的高度,才可以
看到效果,否则元素将自动地被撑开了!

⚠️ 对于内联元素,i, code, span等,其clientWidth/clientHeight,clientLeft/clientTop均都为0;

👉 有这样子的一个计算公式

scrollWidth/scrollHeight = content + padding + overflow的尺寸

也就是可以反向地来计算出溢出的尺寸是多少了:overflow的尺寸 = scrollWidth - content - padding;而当没有溢出的时候,
scrollWidth/scrollHeight = clientWidth/clientHeight

👉 scrollTop/scrollLeft指示滚动条的位置,该属性可读可写,也就是说我们可以通过设置该值,来达到控制元素中的可见区域

🤔最终得出的结论是:一般地,在现代浏览器中,使用的getBoundingClientRect()方法来获取元素在视口中的位置,通过此种方式获取到的数据是静态快照的数据,
但如果我们配合浏览器的加载/滚动/视口缩放等的回调监听,即可实时获取到元素rect区域的一个变化值!