?
本文檔使用 php中文網(wǎng)手冊(cè) 發(fā)布
Text節(jié)點(diǎn)的概念
Text節(jié)點(diǎn)的屬性
data
wholeText
length
nextElementSibling
previousElementSibling
Text節(jié)點(diǎn)的方法
appendData(),deleteData(),insertData(),replaceData(),subStringData()
remove()
splitText(),normalize()
DocumentFragment節(jié)點(diǎn)
Text節(jié)點(diǎn)代表Element節(jié)點(diǎn)和Attribute節(jié)點(diǎn)的文本內(nèi)容。如果一個(gè)節(jié)點(diǎn)只包含一段文本,那么它就有一個(gè)Text子節(jié)點(diǎn),代表該節(jié)點(diǎn)的文本內(nèi)容。通常我們使用Element節(jié)點(diǎn)的firstChild、nextSibling等屬性獲取Text節(jié)點(diǎn),或者使用Document節(jié)點(diǎn)的createTextNode方法創(chuàng)造一個(gè)Text節(jié)點(diǎn)。
// 獲取Text節(jié)點(diǎn) var textNode = document.querySelector('p').firstChild; // 創(chuàng)造Text節(jié)點(diǎn) var textNode = document.createTextNode('Hi'); document.querySelector('div').appendChild(textNode);
瀏覽器原生提供一個(gè)Text構(gòu)造函數(shù)。它返回一個(gè)Text節(jié)點(diǎn)。它的參數(shù)就是該Text節(jié)點(diǎn)的文本內(nèi)容。
var text1 = new Text(); var text2 = new Text("This is a text node");
注意,由于空格也是一個(gè)字符,所以哪怕只有一個(gè)空格,也會(huì)形成Text節(jié)點(diǎn)。
Text節(jié)點(diǎn)除了繼承Node節(jié)點(diǎn)的屬性和方法,還繼承了CharacterData接口。Node節(jié)點(diǎn)的屬性和方法請(qǐng)參考《Node節(jié)點(diǎn)》章節(jié),這里不再重復(fù)介紹了,以下的屬性和方法大部分來(lái)自CharacterData接口。
data屬性等同于nodeValue屬性,用來(lái)設(shè)置或讀取Text節(jié)點(diǎn)的內(nèi)容。
// 讀取文本內(nèi)容 document.querySelector('p').firstChild.data // 等同于 document.querySelector('p').firstChild.nodeValue // 設(shè)置文本內(nèi)容 document.querySelector('p').firstChild.data = 'Hello World';
wholeText屬性將當(dāng)前Text節(jié)點(diǎn)與毗鄰的Text節(jié)點(diǎn),作為一個(gè)整體返回。大多數(shù)情況下,wholeText屬性的返回值,與data屬性和textContent屬性相同。但是,某些特殊情況會(huì)有差異。
舉例來(lái)說(shuō),HTML代碼如下。
<p id="para">A <em>B</em> C</p>
這時(shí),Text節(jié)點(diǎn)的wholeText屬性和data屬性,返回值相同。
var el = document.getElementById("para"); el.firstChild.wholeText // "A " el.firstChild.data // "A "
但是,一旦移除em節(jié)點(diǎn),wholeText屬性與data屬性就會(huì)有差異,因?yàn)檫@時(shí)其實(shí)P節(jié)點(diǎn)下面包含了兩個(gè)毗鄰的Text節(jié)點(diǎn)。
el.removeChild(para.childNodes[1]); el.firstChild.wholeText // "A C" el.firstChild.data // "A "
length屬性返回當(dāng)前Text節(jié)點(diǎn)的文本長(zhǎng)度。
(new Text('Hello')).length // 5
nextElementSibling屬性返回緊跟在當(dāng)前Text節(jié)點(diǎn)后面的那個(gè)同級(jí)Element節(jié)點(diǎn)。如果取不到這樣的節(jié)點(diǎn),則返回null。
// HTML為 // <div>Hello <em>World</em></div> var tn = document.querySelector('div').firstChild; tn.nextElementSibling // <em>World</em>
previousElementSibling屬性返回當(dāng)前Text節(jié)點(diǎn)前面最近的那個(gè)Element節(jié)點(diǎn)。如果取不到這樣的節(jié)點(diǎn),則返回null。
以下5個(gè)方法都是編輯Text節(jié)點(diǎn)文本內(nèi)容的方法。
appendData方法用于在Text節(jié)點(diǎn)尾部追加字符串。
deleteData方法用于刪除Text節(jié)點(diǎn)內(nèi)部的子字符串,第一個(gè)參數(shù)為子字符串位置,第二個(gè)參數(shù)為子字符串長(zhǎng)度。
insertData方法用于在Text節(jié)點(diǎn)插入字符串,第一個(gè)參數(shù)為插入位置,第二個(gè)參數(shù)為插入的子字符串。
replaceData方法用于替換文本,第一個(gè)參數(shù)為替換開(kāi)始位置,第二個(gè)參數(shù)為需要被替換掉的長(zhǎng)度,第三個(gè)參數(shù)為新加入的字符串。
subStringData方法用于獲取子字符串,第一個(gè)參數(shù)為子字符串在Text節(jié)點(diǎn)中的開(kāi)始位置,第二個(gè)參數(shù)為子字符串長(zhǎng)度。
// HTML代碼為 // <p>Hello World</p> var pElementText = document.querySelector('p').firstChild; pElementText.appendData('!'); // 頁(yè)面顯示 Hello World! pElementText.deleteData(7,5); // 頁(yè)面顯示 Hello W pElementText.insertData(7,'Hello '); // 頁(yè)面顯示 Hello WHello pElementText.replaceData(7,5,'World'); // 頁(yè)面顯示 Hello WWorld pElementText.substringData(7,10); // 頁(yè)面顯示不變,返回"World "
remove方法用于移除當(dāng)前Text節(jié)點(diǎn)。
// HTML代碼為 // <p>Hello World</p> document.querySelector('p').firstChild.remove() // 現(xiàn)在頁(yè)面代碼為 // <p></p>
splitText方法將Text節(jié)點(diǎn)一分為二,變成兩個(gè)毗鄰的Text節(jié)點(diǎn)。它的參數(shù)就是分割位置(從零開(kāi)始),分割到該位置的字符前結(jié)束。如果分割位置不存在,將報(bào)錯(cuò)。
分割后,該方法返回分割位置后方的字符串,而原Text節(jié)點(diǎn)變成只包含分割位置前方的字符串。
// html代碼為 <p id="p">foobar</p> var p = document.getElementById('p'); var textnode = p.firstChild; var newText = textnode.splitText(3); newText // "bar" textnode // "foo"
normalize方法可以將毗鄰的兩個(gè)Text節(jié)點(diǎn)合并。
接上面的例子,splitText方法將一個(gè)Text節(jié)點(diǎn)分割成兩個(gè),normalize方法可以實(shí)現(xiàn)逆操作,將它們合并。
p.childNodes.length // 2 // 將毗鄰的兩個(gè)Text節(jié)點(diǎn)合并 p.normalize(); p.childNodes.length // 1
DocumentFragment節(jié)點(diǎn)代表一個(gè)文檔的片段,本身就是一個(gè)完整的DOM樹(shù)形結(jié)構(gòu)。它沒(méi)有父節(jié)點(diǎn),不屬于當(dāng)前文檔,操作DocumentFragment節(jié)點(diǎn),要比直接操作DOM樹(shù)快得多。
它一般用于構(gòu)建一個(gè)DOM結(jié)構(gòu),然后插入當(dāng)前文檔。document.createDocumentFragment方法,以及瀏覽器原生的DocumentFragment構(gòu)造函數(shù),可以創(chuàng)建一個(gè)空的DocumentFragment節(jié)點(diǎn)。然后再使用其他DOM方法,向其添加子節(jié)點(diǎn)。
var docFrag = document.createDocumentFragment(); // or var docFrag = new DocumentFragment(); var li = document.createElement("li"); li.textContent = "Hello World"; docFrag.appendChild(li); document.queryselector('ul').appendChild(docFrag);
上面代碼創(chuàng)建了一個(gè)DocumentFragment節(jié)點(diǎn),然后將一個(gè)li節(jié)點(diǎn)添加在它里面,最后將DocumentFragment節(jié)點(diǎn)移動(dòng)到原文檔。
一旦DocumentFragment節(jié)點(diǎn)被添加進(jìn)原文檔,它自身就變成了空節(jié)點(diǎn)(textContent屬性為空字符串)。如果想要保存DocumentFragment節(jié)點(diǎn)的內(nèi)容,可以使用cloneNode方法。
document.queryselector('ul').(docFrag.cloneNode(true));
DocumentFragment節(jié)點(diǎn)對(duì)象沒(méi)有自己的屬性和方法,全部繼承自Node節(jié)點(diǎn)和ParentNode接口。也就是說(shuō),DocumentFragment節(jié)點(diǎn)比Node節(jié)點(diǎn)多出以下四個(gè)屬性。
children:返回一個(gè)動(dòng)態(tài)的HTMLCollection集合對(duì)象,包括當(dāng)前DocumentFragment對(duì)象的所有子元素節(jié)點(diǎn)。
firstElementChild:返回當(dāng)前DocumentFragment對(duì)象的第一個(gè)子元素節(jié)點(diǎn),如果沒(méi)有則返回null。
lastElementChild:返回當(dāng)前DocumentFragment對(duì)象的最后一個(gè)子元素節(jié)點(diǎn),如果沒(méi)有則返回null。
childElementCount:返回當(dāng)前DocumentFragment對(duì)象的所有子元素?cái)?shù)量。
另外,Node節(jié)點(diǎn)的所有方法,都接受DocumentFragment節(jié)點(diǎn)作為參數(shù)(比如Node.appendChild、Node.insertBefore)。這時(shí),DocumentFragment的子節(jié)點(diǎn)(而不是DocumentFragment節(jié)點(diǎn)本身)將插入當(dāng)前節(jié)點(diǎn)。