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