XML DOM - Range 对象

Range 对象表示文档中的连续范围。

Range 对象

Range 对象表示文档的连续范围区域，如用户在浏览器窗口中用鼠标拖动选中的区域。

如果一个实现支持 Range 模块，那么 Document 对象就定义了 createRange() 方法，调用它可创建新的 Range 对象。

Tahadhari:IE 定义了不兼容的 Document.createRange() 方法，它返回的对象与 Rang 接口相似，但不兼容。

Range 接口为指定文档“选中”的区域定义了大量的方法，此外还有几个方法可以用于在选中的区域中进行剪切和粘贴类型的操作。

Range 接口的属性提供了获取范围的边界节点和偏移量的方法。它的方法提供了设置范围边界的方法。注意，范围的边界可以设置为 Document au DocumentFragment 对象中的节点。一旦定义了范围的边界点，就可以使用 deleteContents()、extractContents()、cloneContents() 和 insertNode() 方法实现剪切、复制和粘贴的操作。

Kama inafanyika kwa kusaidia ama kufaika tuki ya kweli, maneno yote yenye kina kiasi ya kina kiasi zote zitafutika (kama inafaa) kusikitisha wafanyakazi wa kina kiasi wao, kwa hivyo wanaonekana (kama inafaa) kuwafanya tuki ya kweli hiyo.

Maneno: Kina kiasi, kiwango cha kina kiasi na kina kiasi cha kina kiasi

Ujumbe wa kina kiasi una wafanyakazi wawili, kwa upotezi kwa kiwango cha kwanza na kiwango cha kuzaliwa. Kila kiwango kinachopewa na tuki na kina kiasi cha tuki hiyo. Tuki hiyo inahusiana na kina kiasi cha tuki hiyo. Tuki ya Element,Tuki ya Documentau Tuki ya TextKwa Element na Document tuki, kina kiasi kinahesabiwa kama watoto wa tuki hii. Kina kiasi kilichopo 0 inaeleza kwamba kipindi chake kilichopo kwanza cha watoto wa tuki hii. Kina kiasi kilichopo 1 inaeleza kwamba kipindi chake kilichopo kwa wengine cha watoto wa tuki hii kabla ya kwanza. Kama kipindi hicho ni Text tuki, kina kiasi kinahesabiwa kama nafasi ya wengi wa harufi mbili zaidi.

Range 对象的常量

这些常量指定了如何比较 Range 对象的边界点。

它们是 compareBoundaryPoints() 方法的 how Adhira ya vyaandiko:

Wakati wote wanaendelea kwenye method ya compareBoundaryPoints() ya Maelezo
Adhira ya vyaandiko: Kivinjari
START_TO_END Iningatia eneo kufikia kwa kusoma kwa kusababisha kwa kufikia kwa kusoma ya eneo hivi.
END_TO_END Iningatia eneo kufikia kwa kusoma kwa kusababisha kwa kufikia kwa kusoma ya eneo hivi.
END_TO_START Iningatia eneo kufikia kwa kusoma kwa kusababisha kwa kufikia kwa kusoma ya eneo hivi.

Masharti ya Range

Tahadhari:Masharti yote ni yenye uangalifu tu, haikwezingatia kwa kusoma kwa kusababisha kufanywa eneo kwanza na kufikia kwa kusoma, inahitaji kuingia kwenye method ya setEnd() na setStart() kufanyia hii.

Tahadhari:Kwa kila sababu ya kusoma kwa kuzingatia kwa kila masharti baada ya kuingia kwenye method ya detach() inaenda kutoa kosa ya INVALID_STATE_ERR DOMException 异常。

Masharti Maelezo
collapsed Ikiwa kwanza na mwisho ya eneo wanaendelea katika hatua moja ya mawili ya mawili ya eneo, inaathiriwa kwa kweli, i.e. eneo ni hauonekana, au kufupishwa.
commonAncestorContainer Kwanza na mwisho ya eneo (ina ni mababu wa eneo), makala ya Document inayotakaarea ya eneo kwa kina.
endContainer Makala ya Document inayotakaarea ya mwisho ya eneo.
endOffset Pia kwenye endContainer.
startContainer Makala ya Document inayotakaarea ya kwanza ya eneo.
startOffset Pia kwenye startContainer.

Method ya Range

Tahadhari:Ikiwa umeingia kwenye method ya detach() ya eneo, kila method ya Range ya kuzingatia inaenda kutoa kosa ya INVALID_STATE_ERR DOMException 异常。

Method Maelezo
cloneContents() Inarudia DocumentFragment mpya inayotakaarea ya mawili ya Range hivi ya huzuni.
cloneRange() Kumisha Range mpya inayotakaarea ya mawili ya Range hivi ya huzuni.
collapse() 折叠该范围，使它的边界点重合。
compareBoundaryPoints() 比较指定范围的边界点和当前范围的边界点，根据它们的顺序返回 -1、0 和 1。比较哪个边界点由它的第一个参数指定，它的值必须是前面定义的常量之一。
deleteContents() 删除当前 Range 对象表示的文档区域。
detach() 通知实现不再使用当前的范围，可以停止跟踪。如果调用了范围的这个方法，那么接下来调用的该范围任何方法都会抛出代码为 INVALID_STATE_ERR 的 DOMException 异常。
extractContents() 删除当前范围表示的文档区域，并且以 DocumentFragment 对象的形式返回那个区域的内容。该方法和 cloneContents() 方法与 deleteContents() 方法的组合很相似。
insertNode() Ingiza mti ulioonekana kwenye kina cha kwanza cha eneo la hatua.
selectNode() Weka kina cha eneo la hatua kwa sababu ya kina cha kina cha mti na wanaeja wa mti hii.
selectNodeContents() Weka kina cha eneo la hatua kwa sababu ya kina cha kina cha mti na wanaeja wa mti hii, lakini haitakae kina cha kina cha mti.
setEnd() Ingiza kina cha kuu cha eneo la hatua kwenye mti ulioonekana na ukweli wa kina ulioonekana.
setEndAfter() Ingiza kina cha kuu cha eneo la hatua kwenye hali ya kina kwa mti ulioonekana baada ya mti huo.
setEndBefore() Ingiza kina cha kuu cha eneo la hatua kwenye hali ya kina kwa mti ulioonekana kabla.
setStart() Ingiza kina cha kwanza cha eneo la hatua kwenye hali ya kina kwa mti ulioonekana na ukweli wa kina ulioonekana.
setStartAfter() Ingiza kina cha kwanza cha eneo la hatua kwenye hali ya kina kwa mti ulioonekana baada ya mti huo.
setStartBefore() Ingiza kina cha kwanza cha eneo la hatua kwenye hali ya kina kwa mti ulioonekana kabla.
surroundContents() Ingiza mti ulioonekana kwenye kina cha kwanza cha eneo la hatua, kisha kirekebisha wengine wa kina kila mmoja kwenye eneo la hatua kuwa wanaeja wa mti ulioingizwa kwa uwanja huo.
toString() Rudi maandiko ya eneo la hatua ya uambatizo wa kina.