DOM Range

這個(gè)文集是我讀w3c若干標(biāo)準(zhǔn)時(shí)的筆記,比較精煉,希望對(duì)大家有幫助床绪。

DOM Range

邊界點(diǎn)

一個(gè)range有兩個(gè)邊界點(diǎn)(boudary-points)机杜,每個(gè)邊界點(diǎn)用node和offset來(lái)表示帜讲。
node是邊界點(diǎn)的容器,它也就對(duì)應(yīng)DOM中的node椒拗,可以是Element\Comment\ProcessingInstruction\EntityReference\CDATASection\Document\DocumentFragment\Attr\Text類型的節(jié)點(diǎn)似将。但是邊界點(diǎn)的node不能是DocumentType\Entity\Notation類型。

一個(gè)range的每個(gè)邊界點(diǎn)都有一個(gè)container(node)蚀苛,這些node的父元素也是這個(gè)range的container在验,這樣,兩個(gè)邊界點(diǎn)必定有一個(gè)共有的container堵未,我們叫做這個(gè)range的根container腋舌。

如果一個(gè)range的兩個(gè)邊界點(diǎn)有相同的node和offset,那么渗蟹,我們稱這個(gè)range為collapsed Range块饺。這常常出現(xiàn)在插入光標(biāo)的情況。

selection和partial selection(選中和部分選中)

如果一個(gè)node或者16位字符位于range之中(怎樣才位于range之中雌芽,想想就知道了)授艰。那么我們說(shuō)這個(gè)node或字符被選中了(selected)。上圖中的例子膘怕,range2選中了P節(jié)點(diǎn)想诅,但是range4沒(méi)有選中那個(gè)文本節(jié)點(diǎn)。

我們說(shuō)一個(gè)節(jié)點(diǎn)被部分選中了岛心,如果這個(gè)節(jié)點(diǎn)是并且只是一個(gè)邊界點(diǎn)的Container来破。

創(chuàng)建一個(gè)range

var range = document.createRange();

創(chuàng)建的range的container是document,offset是0忘古,是一個(gè)collapsed range徘禁。
獲取邊界點(diǎn)信息:

range.startContainer;
range.startOffset;

設(shè)定邊界點(diǎn)信息:

range.setStart(node,offset)

注意node是dom類型。offset不能超出實(shí)際下標(biāo)髓堪,不然報(bào)錯(cuò)IndexSizeError: DOM Exception xx;
還有幾個(gè)常用的設(shè)定邊界點(diǎn)的接口:

range.setStartBefore(node)
range.setStartAfter(node)

合并range:

range.collapse();

判斷range是否是合并:

range.collapsed;  //只讀

設(shè)定一個(gè)range選中某節(jié)點(diǎn)或節(jié)點(diǎn)內(nèi)容:

range.selectNode(node);
range.selectNodeContent(node);

判斷兩個(gè)邊界點(diǎn)的位置關(guān)系

首先這樣判斷連個(gè)邊界點(diǎn)的位置關(guān)系:

range1.compareBoundaryPoints(Range.START_TO_START,range2);

這樣就是range1的起始點(diǎn)和range2的起始點(diǎn)比較送朱。
返回值為-1,0,1娘荡,分別代表小于、等于驶沼、大于的情況炮沐。
然后:比較兩個(gè)邊界點(diǎn)的算法如下:

  1. 如果A點(diǎn)和B點(diǎn)有同一個(gè)container,比較他們的offset
  2. 如果A點(diǎn)的container是B點(diǎn)的祖先container回怜。比較A的offset和B的祖先container的位置大年。
  3. 同第2點(diǎn)。B的情況
  4. 如果以上都不是玉雾,A的container和B的container是兄弟節(jié)點(diǎn)或者是旁系血親翔试。那么比較A的container和Bcontainer在先序遍歷中的先后關(guān)系。

刪除range中的內(nèi)容

range.deleteContents();

刪除range中的內(nèi)容后复旬,如果一個(gè)node被range“選中”垦缅,那么這個(gè)node被刪除掉;如果這個(gè)node被“部分選中”驹碍,只刪除node中被選中的部分壁涎。

例如:

<div>hi <p>hel|lo </p> wor|ld</div>  //兩條豎線代表邊界點(diǎn)
<div>hi <p>hel</p>|ld</div>   //刪除后的結(jié)果,range合并于豎線的地方

關(guān)于合并點(diǎn):

  1. 如果沒(méi)有node被部分選中幸冻,直接刪除粹庞,range合并于start位置
  2. 如果有node被部分選中了,range刪除后合并于元素之后或者之前洽损。

抽出內(nèi)容

提取內(nèi)容:

range.extractContents();

提取的內(nèi)容會(huì)暫時(shí)從dom節(jié)點(diǎn)中刪除庞溜。方法返回的內(nèi)容為documentFragment。
需要注意的是:如果一個(gè)node被選中碑定,這個(gè)節(jié)點(diǎn)從dom中刪除流码,直接放進(jìn)返回的documentFragment中,如果一個(gè)node被部分選中延刘,或克隆這個(gè)節(jié)點(diǎn)放進(jìn)documentFragment中漫试。
一定要注意的是,克隆一個(gè)節(jié)點(diǎn)的時(shí)候會(huì)克隆所有的attr屬性碘赖,比如ID驾荣。

克隆內(nèi)容

range.cloneContents();

插入內(nèi)容

range.insertNode(node);

在range的start處插入node,同時(shí)node也可以是一個(gè)documentFragment普泡,例如:

range.insertNode(range1.extrctContents());

包裹內(nèi)容

range.surroundContents(node);

如果range部分選擇了一個(gè)非文本節(jié)點(diǎn)播掷,那么此方法會(huì)拋出一個(gè)DOM異常。

克隆range

range.cloneRange();

獲取根container

range.commonAncestorContainer  //只讀

獲取所有文本內(nèi)容

range.toString();  //返回的內(nèi)容類型為"DOMString"

文檔變化后的range情況

讓文檔中的節(jié)點(diǎn)發(fā)生了變化撼班,那么關(guān)聯(lián)的range會(huì)自動(dòng)更新歧匈。

插入

如果一個(gè)節(jié)點(diǎn)插入在range之前,那么range的startOffset和endOffset會(huì)發(fā)生變化砰嘁,container不會(huì)變化件炉。
如果一個(gè)節(jié)點(diǎn)插入的位置恰好是range的一個(gè)邊界點(diǎn)的位置勘究。w3c標(biāo)準(zhǔn)采取的策略是:盡量不要讓range的container和offset變動(dòng)。那么斟冕,在邊界點(diǎn)的位置插入一個(gè)節(jié)點(diǎn)時(shí)候口糕,會(huì)按情況選擇插入range里面還是外面】纳撸看下面的例子:

<div>|wor|ld</div>   
//然后在start的位置插入hello走净,結(jié)果是
<div>|hello wor|ld</div>   //這樣保證了startOffset一直是0不變
//或者在end的位置插入pew!,結(jié)果是
<div>|wor|pre!ld</div>   //這樣保證了start和end的位置都沒(méi)變

刪除節(jié)點(diǎn)

刪除一個(gè)節(jié)點(diǎn)后range的變化情況孤里,可以想象成要?jiǎng)h除的范圍range2.deleteContents()后這個(gè)range1怎么變化。

  1. 如果range1的邊界點(diǎn)在range2之內(nèi)橘洞,那么range2.deleteContents()之后捌袜,range2.會(huì)合并,那么range1的這個(gè)邊界點(diǎn)也會(huì)合并到和range2同一點(diǎn)上炸枣。
  2. 如果range1的邊界點(diǎn)在range2之后虏等,那么range2刪除后可能會(huì)更新range1這個(gè)邊界點(diǎn)的offset。
  3. 如果range1的邊界點(diǎn)在range2之前适肠,那么range2的刪除對(duì)range1的這個(gè)邊界點(diǎn)沒(méi)有影響霍衫。
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市侯养,隨后出現(xiàn)的幾起案子敦跌,更是在濱河造成了極大的恐慌,老刑警劉巖逛揩,帶你破解...
    沈念sama閱讀 217,509評(píng)論 6 504
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件柠傍,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡辩稽,警方通過(guò)查閱死者的電腦和手機(jī)惧笛,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,806評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)逞泄,“玉大人患整,你說(shuō)我怎么就攤上這事∨缰冢” “怎么了各谚?”我有些...
    開(kāi)封第一講書(shū)人閱讀 163,875評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)侮腹。 經(jīng)常有香客問(wèn)我嘲碧,道長(zhǎng),這世上最難降的妖魔是什么父阻? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,441評(píng)論 1 293
  • 正文 為了忘掉前任愈涩,我火速辦了婚禮望抽,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘履婉。我一直安慰自己煤篙,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,488評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布毁腿。 她就那樣靜靜地躺著辑奈,像睡著了一般。 火紅的嫁衣襯著肌膚如雪已烤。 梳的紋絲不亂的頭發(fā)上鸠窗,一...
    開(kāi)封第一講書(shū)人閱讀 51,365評(píng)論 1 302
  • 那天,我揣著相機(jī)與錄音胯究,去河邊找鬼稍计。 笑死,一個(gè)胖子當(dāng)著我的面吹牛裕循,可吹牛的內(nèi)容都是我干的臣嚣。 我是一名探鬼主播,決...
    沈念sama閱讀 40,190評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼剥哑,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼硅则!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起株婴,我...
    開(kāi)封第一講書(shū)人閱讀 39,062評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤怎虫,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后督暂,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體揪垄,經(jīng)...
    沈念sama閱讀 45,500評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,706評(píng)論 3 335
  • 正文 我和宋清朗相戀三年逻翁,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了饥努。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 39,834評(píng)論 1 347
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡八回,死狀恐怖酷愧,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情缠诅,我是刑警寧澤溶浴,帶...
    沈念sama閱讀 35,559評(píng)論 5 345
  • 正文 年R本政府宣布,位于F島的核電站管引,受9級(jí)特大地震影響士败,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,167評(píng)論 3 328
  • 文/蒙蒙 一谅将、第九天 我趴在偏房一處隱蔽的房頂上張望漾狼。 院中可真熱鬧,春花似錦饥臂、人聲如沸逊躁。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,779評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)稽煤。三九已至,卻和暖如春囚戚,著一層夾襖步出監(jiān)牢的瞬間酵熙,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 32,912評(píng)論 1 269
  • 我被黑心中介騙來(lái)泰國(guó)打工驰坊, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留绿店,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 47,958評(píng)論 2 370
  • 正文 我出身青樓庐橙,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親借嗽。 傳聞我的和親對(duì)象是個(gè)殘疾皇子态鳖,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,779評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容