document节点

概述

document节点是文档的根节点,每张网页都有自己的document节点。window.document属性就指向这个节点。只要浏览器开始载入HTML文档,这个节点对象就存在了,可以直接调用。

document节点有不同的办法可以获取。

  • 对于正常的网页,直接使用documentwindow.document
  • 对于iframe载入的网页,使用iframe节点的contentDocument属性。
  • 对Ajax操作返回的文档,使用XMLHttpRequest对象的responseXML属性。
  • 对于包含某个节点的文档,使用该节点的ownerDocument属性。

上面这四种document节点,都部署了Document接口,因此有共同的属性和方法。当然,各自也有一些自己独特的属性和方法,比如HTML和XML文档的document节点就不一样。

内部节点属性

document节点有很多属性,其中相当一部分属于快捷方式,指向文档内部的某个节点。

document.doctype,document.documentElement,document.defaultView

对于HTML文档来说,document对象一般有两个子节点。第一个子节点是document.doctype,它是一个对象,包含了当前文档类型(Document Type Declaration,简写DTD)信息。对于HTML5文档,该节点就代表。如果网页没有声明DTD,该属性返回null

var doctype = document.doctype;
doctype // ""
doctype.name // "html"

document.firstChild通常就返回这个节点。

document.documentElement属性返回当前文档的根节点(root)。它通常是document节点的第二个子节点,紧跟在document.doctype节点后面。对于HTML网页,该属性返回节点。

document.defaultView属性,在浏览器中返回document对象所在的window对象,否则返回null

document.defaultView === window // true

document.body,document.head

document.head属性返回当前文档的节点,document.body属性返回当前文档的

document.head === document.querySelector('head') // true
document.body === document.querySelector('body') // true

这两个属性总是存在的,如果网页源码里面省略了,浏览器会自动创造。另外,这两个属性是可写的,如果对其写入一个新的节点,会导致原有的所有子节点被移除。

document.activeElement

document.activeElement属性返回当前文档中获得焦点的那个元素。用户通常可以使用Tab键移动焦点,使用空格键激活焦点。比如,如果焦点在一个链接上,此时按一下空格键,就会跳转到该链接。

节点集合属性

以下属性返回文档内部特定元素的集合,都是类似数组的对象。这些集合都是动态的,原节点有任何变化,立刻会反映在集合中。

document.links,document.forms,document.images,document.embeds

document.links属性返回当前文档所有设定了href属性的aarea元素。

document.forms属性返回页面中所有表单元素form

var selectForm = document.forms[0];

上面代码获取文档第一个表单。

document.images属性返回页面所有图片元素(即img标签)。

var imglist = document.images;

for(var i = 0; i < imglist.length; i++) {
  if (imglist[i].src === 'banner.gif') {
    // ...
  }
}

上面代码在所有img标签中,寻找特定图片。

document.embeds属性返回网页中所有嵌入对象,即embed标签。

以上四个属性返回的都是HTMLCollection对象实例。

document.links instanceof HTMLCollection // true
document.images instanceof HTMLCollection // true
document.forms instanceof HTMLCollection // true
document.embeds instanceof HTMLCollection // true

由于HTMLCollection实例可以用HTML元素的idname属性引用,因此如果一个元素有idname属性,就可以在上面这四个属性上引用。

// HTML代码为
// 
document.myForm === document.forms.myForm // true

document.scripts,document.styleSheets

document.scripts属性返回当前文档的所有脚本(即script标签)。

var scripts = document.scripts;
if (scripts.length !== 0 ) {
  console.log('当前网页有脚本');
}

document.scripts返回的也是HTMLCollection实例。

document.scripts instanceof HTMLCollection // true

因此,如果一个script标签有idname属性,就可以在document.scripts上引用。

// HTML代码为
// 

document.styleSheets属性返回一个类似数组的对象,代表当前网页的所有样式表。每个样式表对象都有cssRules属性,返回该样式表的所有CSS规则,这样这可以操作具体的CSS规则了。

var allSheets = [].slice.call(document.styleSheets);

上面代码中,使用slice方法将document.styleSheets转为数组,以便于进一步处理。

文档信息属性

以下属性返回文档信息。

document.documentURI,document.URL

document.documentURI属性和document.URL属性都返回一个字符串,表示当前文档的网址。不同之处是documentURI属性可用于所有文档(包括 XML 文档),URL属性只能用于 HTML 文档。

document.URL
// http://www.example.com/about

document.documentURI === document.URL
// true

如果文档的锚点(#anchor)变化,这两个属性都会跟着变化。

document.domain

document.domain属性返回当前文档的域名。比如,某张网页的网址是 http://www.example.com/hello.html ,domain属性就等于[www.example.com](http://www.example.com/)。如果无法获取域名,该属性返回null

var badDomain = 'www.example.xxx';
if (document.domain === badDomain)
  window.close();

上面代码判断,如果当前域名等于指定域名,则关闭窗口。

二级域名的情况下,domain属性可以设置为对应的一级域名。比如,当前域名是sub.example.com,则domain属性可以设置为example.com。除此之外的写入,都是不可以的。

document.lastModified

document.lastModified属性返回当前文档最后修改的时间戳,格式为字符串。

document.lastModified
// Tuesday, July 10, 2001 10:19:42

注意,lastModified属性的值是字符串,所以不能用来直接比较,两个文档谁的日期更新,需要用Date.parse方法转成时间戳格式,才能进行比较。

if (Date.parse(doc1.lastModified) > Date.parse(doc2.lastModified)) {
  // ...
}

document.location

document.location属性返回location对象,提供了当前文档的URL信息。

// 当前网址为 http://user:[email protected]:4097/path/a.html?x=111#part1
document.location.href // "http://user:[email protected]:4097/path/a.html?x=111#part1"
document.location.protocol // "http:"
document.location.host // "www.example.com:4097"
document.location.hostname // "www.example.com"
document.location.port // "4097"
document.location.pathname // "/path/a.html"
document.location.search // "?x=111"
document.location.hash // "#part1"
document.location.user // "user"
document.location.password // "passwd"

location对象有以下方法。

  • location.assign()
  • location.reload()
  • location.toString()
// 跳转到另一个网址
document.location.assign('http://www.google.com')
// 优先从服务器重新加载
document.location.reload(true)
// 优先从本地缓存重新加载(默认值)
document.location.reload(false)
// 跳转到新网址,并将取代掉history对象中的当前记录
document.location.replace('http://www.google.com');
// 将location对象转为字符串,等价于document.location.href
document.location.toString()

如果将新的网址赋值给location对象,网页就会自动跳转到新网址。

document.location = 'http://www.example.com';
// 等同于
document.location.href = 'http://www.example.com';

也可以指定相对URL。

document.location = 'page2.html';

如果指定的是锚点,浏览器会自动滚动到锚点处。

document.location = '#top';

注意,采用上面的方法重置URL,跟用户点击链接跳转的效果是一样的。上一个网页依然将保存在浏览器历史之中,点击“后退”按钮就可以回到前一个网页。

如果不希望用户看到前一个网页,可以使用location.replace方法,浏览器history对象就会用新的网址,取代当前网址,这样的话,“后退”按钮就不会回到当前网页了。它的一个应用就是,当脚本发现当前是移动设备时,就立刻跳转到移动版网页。

document.location属性与window.location属性等价。

document.location === window.location // true

历史上,IE曾经不允许对document.location赋值,为了保险起见,建议优先使用window.location。如果只是单纯地获取当前网址,建议使用document.URL,语义性更好。

document.referrer,document.title,document.characterSet

document.referrer属性返回一个字符串,表示当前文档的访问来源,如果是无法获取来源或是用户直接键入网址,而不是从其他网页点击,则返回一个空字符串。

document.referrer的值,总是与HTTP头信息的Referer保持一致,但是它的拼写有两个r

document.title属性返回当前文档的标题,该属性是可写的。

document.title = '新标题';

document.characterSet属性返回渲染当前文档的字符集,比如UTF-8、ISO-8859-1。

document.readyState

document.readyState属性返回当前文档的状态,共有三种可能的值。

  • loading:加载HTML代码阶段(尚未完成解析)
  • interactive:加载外部资源阶段时
  • complete:加载完成时

这个属性变化的过程如下。

  1. 浏览器开始解析HTML文档,document.readyState属性等于loading
  2. 浏览器遇到HTML文档中的

    document.implementation

    document.implementation属性返回一个对象,用来甄别当前环境部署了哪些DOM相关接口。implementation属性的hasFeature方法,可以判断当前环境是否部署了特定版本的特定接口。

    document.implementation.hasFeature('HTML', '2.0')
    // true
    
    document.implementation.hasFeature('MutationEvents','2.0')
    // true
    
    

    上面代码表示,当前环境部署了DOM HTML 2.0版和MutationEvents的2.0版。

    document.compatMode

    compatMode属性返回浏览器处理文档的模式,可能的值为BackCompat(向后兼容模式)和CSS1Compat(严格模式)。

    一般来说,如果网页代码的第一行设置了明确的DOCTYPE(比如),document.compatMode的值都为CSS1Compat

    document.cookie

    document.cookie属性用来操作浏览器Cookie,详见《浏览器环境》一章的《Cookie》部分。

    读写相关的方法

    document.write(),document.writeln()

    document.write方法用于向当前文档写入内容。只要当前文档还没有用close方法关闭,它所写入的内容就会追加在已有内容的后面。

    // 页面显示“helloworld”
    document.open();
    document.write('hello');
    document.write('world');
    document.close();
    
    

    注意,document.write会当作HTML代码解析,不会转义。

    document.write('

    hello world

    ');

    如果页面已经解析完成(DOMContentLoaded事件发生之后),再调用write方法,它会先调用open方法,擦除当前文档所有内容,然后再写入。

    document.addEventListener('DOMContentLoaded', function (event) {
      document.write('

    Hello World!

    '); }); // 等同于 document.addEventListener('DOMContentLoaded', function (event) { document.open(); document.write('

    Hello World!

    '); document.close(); });

    如果在页面渲染过程中调用write方法,并不会调用open方法。(可以理解成,open方法已调用,但close方法还未调用。)

    
    
    hello
    
    
    
    
    

    在浏览器打开上面网页,将会显示hello world

    document.write是JavaScript语言标准化之前就存在的方法,现在完全有更符合标准的方法向文档写入内容(比如对innerHTML属性赋值)。所以,除了某些特殊情况,应该尽量避免使用document.write这个方法。

    document.writeln方法与write方法完全一致,除了会在输出内容的尾部添加换行符。

    document.write(1);
    document.write(2);
    // 12
    
    document.writeln(1);
    document.writeln(2);
    // 1
    // 2
    //
    
    

    注意,writeln方法添加的是ASCII码的换行符,渲染成HTML网页时不起作用,即在网页上显示不出换行。

    查找节点的方法

    以下方法用来查找某个节点。

    document.querySelector(),document.querySelectorAll()

    document.querySelector方法接受一个CSS选择器作为参数,返回匹配该选择器的元素节点。如果有多个节点满足匹配条件,则返回第一个匹配的节点。如果没有发现匹配的节点,则返回null

    var el1 = document.querySelector('.myclass');
    var el2 = document.querySelector('#myParent > [ng-click]');
    
    

    document.querySelectorAll方法与querySelector用法类似,区别是返回一个NodeList对象,包含所有匹配给定选择器的节点。

    elementList = document.querySelectorAll('.myclass');
    
    

    这两个方法的参数,可以是逗号分隔的多个CSS选择器,返回匹配其中一个选择器的元素节点。

    var matches = document.querySelectorAll('div.note, div.alert');
    
    

    上面代码返回class属性是notealertdiv元素。

    这两个方法都支持复杂的CSS选择器。

    // 选中data-foo-bar属性等于someval的元素
    document.querySelectorAll('[data-foo-bar="someval"]');
    
    // 选中myForm表单中所有不通过验证的元素
    document.querySelectorAll('#myForm :invalid');
    
    // 选中div元素,那些class含ignore的除外
    document.querySelectorAll('DIV:not(.ignore)');
    
    // 同时选中div,a,script三类元素
    document.querySelectorAll('DIV, A, SCRIPT');
    
    

    但是,它们不支持CSS伪元素的选择器(比如:first-line:first-letter)和伪类的选择器(比如:link:visited),即无法选中伪元素和伪类。

    如果querySelectorAll方法的参数是字符串*,则会返回文档中的所有HTML元素节点。另外,querySelectorAll的返回结果不是动态集合,不会实时反映元素节点的变化。

    最后,这两个方法除了定义在document对象上,还定义在元素节点上,即在元素节点上也可以调用。

    document.getElementsByTagName()

    document.getElementsByTagName方法返回所有指定HTML标签的元素,返回值是一个类似数组的HTMLCollection对象,可以实时反映HTML文档的变化。如果没有任何匹配的元素,就返回一个空集。

    var paras = document.getElementsByTagName('p');
    
    paras instanceof HTMLCollection // true
    
    

    上面代码返回当前文档的所有p元素节点。

    HTML标签名是大小写不敏感的,因此getElementsByTagName方法也是大小写不敏感的。另外,返回结果中,各个成员的顺序就是它们在文档中出现的顺序。

    如果传入*,就可以返回文档中所有HTML元素。

    var allElements = document.getElementsByTagName('*');
    
    

    注意,HTML元素本身也定义了getElementsByTagName方法,返回该元素的后代元素中符合指定标签的元素。也就是说,这个方法不仅可以在document对象上调用,也可以在任何元素节点上调用。

    var firstPara = document.getElementsByTagName('p')[0];
    var spans = firstPara.getElementsByTagName('span');
    
    

    上面代码选中第一个p元素内部的所有span元素。

    document.getElementsByClassName()

    document.getElementsByClassName方法返回一个类似数组的对象(HTMLCollection实例对象),包括了所有class名字符合指定条件的元素,元素的变化实时反映在返回结果中。

    var elements = document.getElementsByClassName(names);
    
    

    由于class是保留字,所以JavaScript一律使用className表示CSS的class

    如果参数是一个空格分隔的字符串,元素的class必须符合所有字符串之中所有的class才会返回。

    var elements = document.getElementsByClassName('foo bar');
    
    

    上面代码返回同时具有foobar两个class的元素,foobar的顺序不重要。

    注意,正常模式下,CSS的class是大小写敏感的。(quirks mode下,大小写不敏感。)

    getElementsByTagName方法一样,getElementsByClassName方法不仅可以在document对象上调用,也可以在任何元素节点上调用。

    // 非document对象上调用
    var elements = rootElement.getElementsByClassName(names);
    
    

    document.getElementsByName()

    document.getElementsByName方法用于选择拥有name属性的HTML元素(比如等),返回一个类似数组的的对象(NodeList对象的实例),因为name属性相同的元素可能不止一个。

    // 表单为 
    var forms = document.getElementsByName('x');
    forms[0].tagName // "FORM"
    
    

    getElementById()

    getElementById方法返回匹配指定id属性的元素节点。如果没有发现匹配的节点,则返回null

    var elem = document.getElementById('para1');
    
    

    注意,该方法的参数是大小写敏感的。比如,如果某个节点的id属性是main,那么document.getElementById('Main')将返回null,而不是那个节点。

    document.getElementById方法与document.querySelector方法都能获取元素节点,不同之处是document.querySelector方法的参数使用CSS选择器语法,document.getElementById方法的参数是HTML标签元素的id属性。

    document.getElementById('myElement')
    document.querySelector('#myElement')
    
    

    上面代码中,两个方法都能选中idmyElement的元素,但是getElementById()querySelector()效率高得多。

    另外,这个方法只能在document对象上使用,不能在其他元素节点上使用。

    document.elementFromPoint()

    document.elementFromPoint方法返回位于页面指定位置最上层的Element子节点。

    var element = document.elementFromPoint(50, 50);
    
    

    上面代码选中在(50, 50)这个坐标位置的最上层的那个HTML元素。

    elementFromPoint方法的两个参数,依次是相对于当前视口左上角的横坐标和纵坐标,单位是像素。如果位于该位置的HTML元素不可返回(比如文本框的滚动条),则返回它的父元素(比如文本框)。如果坐标值无意义(比如负值或超过视口大小),则返回null

    生成节点的方法

    以下方法用于生成元素节点。

    document.createElement()

    document.createElement方法用来生成网页元素节点。

    var newDiv = document.createElement('div');
    
    

    createElement方法的参数为元素的标签名,即元素节点的tagName属性,对于 HTML 网页大小写不敏感,即参数为divDIV返回的是同一种节点。如果参数里面包含尖括号(即<>)会报错。

    document.createElement('
    ') // DOMException: The tag name provided ('
    ') is not a valid name

    document.createTextNode()

    document.createTextNode方法用来生成文本节点,参数为所要生成的文本节点的内容。

    var newDiv = document.createElement('div');
    var newContent = document.createTextNode('Hello');
    newDiv.appendChild(newContent);
    
    

    上面代码新建一个div节点和一个文本节点,然后将文本节点插入div节点。

    这个方法可以确保返回的节点,被浏览器当作文本渲染,而不是当作HTML代码渲染。因此,可以用来展示用户的输入,避免XSS攻击。

    var div = document.createElement('div');
    div.appendChild(document.createTextNode('Foo & bar'));
    console.log(div.innerHTML)
    // <span>Foo & bar</span>
    
    

    上面代码中,createTextNode方法对大于号和小于号进行转义,从而保证即使用户输入的内容包含恶意代码,也能正确显示。

    需要注意的是,该方法不对单引号和双引号转义,所以不能用来对HTML属性赋值。

    function escapeHtml(str) {
      var div = document.createElement('div');
      div.appendChild(document.createTextNode(str));
      return div.innerHTML;
    };
    
    var userWebsite = '" onmouseover="alert(\'derp\')" "';
    var profileLink = 'Bob';
    var div = document.getElementById('target');
    div.innerHTML = profileLink;
    // Bob
    
    

    上面代码中,由于createTextNode方法不转义双引号,导致onmouseover方法被注入了代码。

    document.createAttribute()

    document.createAttribute方法生成一个新的属性对象节点,并返回它。

    attribute = document.createAttribute(name);
    
    

    createAttribute方法的参数name,是属性的名称。

    var node = document.getElementById("div1");
    var a = document.createAttribute("my_attrib");
    a.value = "newVal";
    node.setAttributeNode(a);
    
    // 等同于
    
    var node = document.getElementById("div1");
    node.setAttribute("my_attrib", "newVal");
    
    

    document.createDocumentFragment()

    createDocumentFragment方法生成一个DocumentFragment对象。

    var docFragment = document.createDocumentFragment();
    
    

    DocumentFragment对象是一个存在于内存的DOM片段,但是不属于当前文档,常常用来生成较复杂的DOM结构,然后插入当前文档。这样做的好处在于,因为DocumentFragment不属于当前文档,对它的任何改动,都不会引发网页的重新渲染,比直接修改当前文档的DOM有更好的性能表现。

    var docfrag = document.createDocumentFragment();
    
    [1, 2, 3, 4].forEach(function(e) {
      var li = document.createElement("li");
      li.textContent = e;
      docfrag.appendChild(li);
    });
    
    document.body.appendChild(docfrag);
    
    

    事件相关的方法

    document.createEvent()

    document.createEvent方法生成一个事件对象,该对象可以被element.dispatchEvent方法使用,触发指定事件。

    var event = document.createEvent(type);
    
    

    createEvent方法的参数是事件类型,比如UIEvents、MouseEvents、MutationEvents、HTMLEvents。

    var event = document.createEvent('Event');
    event.initEvent('build', true, true);
    document.addEventListener('build', function (e) {
      // ...
    }, false);
    document.dispatchEvent(event);
    
    

    document.addEventListener(),document.removeEventListener(),document.dispatchEvent()

    以下三个方法与document节点的事件相关。这些方法都继承自EventTarget接口,详细介绍参见《Event对象》章节的《EventTarget》部分。

    // 添加事件监听函数
    document.addEventListener('click', listener, false);
    
    // 移除事件监听函数
    document.removeEventListener('click', listener, false);
    
    // 触发事件
    var event = new Event('click');
    document.dispatchEvent(event);
    
    

    其他方法

    document.hasFocus()

    document.hasFocus方法返回一个布尔值,表示当前文档之中是否有元素被激活或获得焦点。

    var focused = document.hasFocus();
    
    

    注意,有焦点的文档必定被激活(active),反之不成立,激活的文档未必有焦点。比如如果用户点击按钮,从当前窗口跳出一个新窗口,该新窗口就是激活的,但是不拥有焦点。

    document.createNodeIterator(),document.createTreeWalker()

    以下方法用于遍历元素节点。

    (1)document.createNodeIterator()

    document.createNodeIterator方法返回一个DOM的子节点遍历器。

    var nodeIterator = document.createNodeIterator(
      document.body,
      NodeFilter.SHOW_ELEMENT
    );
    
    

    上面代码返回body元素的遍历器。createNodeIterator方法的第一个参数为遍历器的根节点,第二个参数为所要遍历的节点类型,这里指定为元素节点。其他类型还有所有节点(NodeFilter.SHOW_ALL)、文本节点(NodeFilter.SHOW_TEXT)、评论节点(NodeFilter.SHOW_COMMENT)等。

    所谓“遍历器”,在这里指可以用nextNode方法和previousNode方法依次遍历根节点的所有子节点。

    var nodeIterator = document.createNodeIterator(document.body);
    var pars = [];
    var currentNode;
    
    while (currentNode = nodeIterator.nextNode()) {
      pars.push(currentNode);
    }
    
    

    上面代码使用遍历器的nextNode方法,将根节点的所有子节点,按照从头部到尾部的顺序,读入一个数组。nextNode方法先返回遍历器的内部指针所在的节点,然后会将指针移向下一个节点。所有成员遍历完成后,返回null。previousNode方法则是先将指针移向上一个节点,然后返回该节点。

    var nodeIterator = document.createNodeIterator(
      document.body,
      NodeFilter.SHOW_ELEMENT
    );
    
    var currentNode = nodeIterator.nextNode();
    var previousNode = nodeIterator.previousNode();
    
    currentNode === previousNode // true
    
    

    上面代码中,currentNode和previousNode都指向同一个的节点。

    有一个需要注意的地方,遍历器返回的第一个节点,总是根节点。

    (2)document.createTreeWalker()

    document.createTreeWalker方法返回一个DOM的子树遍历器。它与createNodeIterator方法的区别在于,后者只遍历子节点,而它遍历整个子树。

    document.createTreeWalker方法的第一个参数,是所要遍历的根节点,第二个参数指定所要遍历的节点类型。

    var treeWalker = document.createTreeWalker(
      document.body,
      NodeFilter.SHOW_ELEMENT
    );
    
    var nodeList = [];
    
    while(treeWalker.nextNode()) nodeList.push(treeWalker.currentNode);
    
    

    上面代码遍历body节点下属的所有元素节点,将它们插入nodeList数组。

    document.adoptNode()

    document.adoptNode方法将某个节点,从其原来所在的文档移除,插入当前文档,并返回插入后的新节点。

    node = document.adoptNode(externalNode);
    
    

    document.importNode()

    document.importNode方法从外部文档拷贝指定节点,插入当前文档。

    var node = document.importNode(externalNode, deep);
    
    

    document.importNode方法用于创造一个外部节点的拷贝,然后插入当前文档。它的第一个参数是外部节点,第二个参数是一个布尔值,表示对外部节点是深拷贝还是浅拷贝,默认是浅拷贝(false)。虽然第二个参数是可选的,但是建议总是保留这个参数,并设为true

    注意,importNode方法只是拷贝外部节点,这时该节点的父节点是null。下一步还必须将这个节点插入当前文档的DOM树。

    var iframe = document.getElementsByTagName('iframe')[0];
    var oldNode = iframe.contentWindow.document.getElementById('myNode');
    var newNode = document.importNode(oldNode, true);
    document.getElementById("container").appendChild(newNode);
    
    

    上面代码从iframe窗口,拷贝一个指定节点myNode,插入当前文档。

    document.getSelection()

    这个方法指向window.getSelection(),参见window对象一节的介绍。

    你可能感兴趣的:(document节点)