XML DOM compareBoundaryPoints() 方法
定義和用法
compareBoundaryPoints() 方法比較兩個(gè)范圍的位置。
語(yǔ)法：
compareBoundaryPoints(how,sourceRange)
參數(shù)
| 參數(shù) | 描述 |
|---|---|
| how | 聲明如何執(zhí)行比較操作（即比較哪些邊界點(diǎn)）。它的合法值是 Range 接口定義的常量。 |
| sourceRange | 要與當(dāng)前范圍進(jìn)行比較的范圍。 |
返回值
如果當(dāng)前范圍的指定邊界點(diǎn)位于 sourceRange 指定的邊界點(diǎn)之前，則返回 -1。如果指定的兩個(gè)邊界點(diǎn)相同，則返回 0。如果當(dāng)前范圍的邊界點(diǎn)位于 sourceRange 指定的邊界點(diǎn)之后，則返回 1。
拋出
如果 sourceRange 表示的文檔不同于當(dāng)前范圍表示的文檔，該方法將拋出代碼為 WRONG_DOCUMENT_ERR 的 DOMException 異常。
描述
該方法將比較當(dāng)前范圍的邊界點(diǎn)和指定的 sourceRange 的邊界點(diǎn)，并返回一個(gè)值，聲明它們?cè)谠次臋n中的相對(duì)位置。參數(shù) how 指定了比較兩個(gè)范圍的哪個(gè)邊界點(diǎn)。該參數(shù)的合法值和它們的含義如下：
- Range.START_TO_START - 比較兩個(gè) Range 節(jié)點(diǎn)的開(kāi)始點(diǎn)
- Range.END_TO_END - 比較兩個(gè) Range 節(jié)點(diǎn)的結(jié)束點(diǎn)
- Range.START_TO_END - 用 sourceRange 的開(kāi)始點(diǎn)與當(dāng)前范圍的結(jié)束點(diǎn)比較
- Range.END_TO_START - 用 sourceRange 的結(jié)束點(diǎn)與當(dāng)前范圍的開(kāi)始點(diǎn)比較
該方法的返回值是一個(gè)數(shù)字，聲明了當(dāng)前范圍相對(duì)于 sourceRange 的位置。因此，您可能認(rèn)為，首先需要用參數(shù) how 的范圍常量指定當(dāng)前范圍的邊界點(diǎn)，然后再用它指定 sourceRange 的邊界點(diǎn)。但事實(shí)上，常量 Range.START_TO_END 指定與當(dāng)前范圍的 end 點(diǎn)和 sourceRange 的 start 點(diǎn)進(jìn)行比較。同樣，常量 Range.END_TO_START 指定比較當(dāng)前范圍的 start 點(diǎn)和指定范圍的 end 點(diǎn)。