XML DOM compareBoundaryPoints() 方法

定义和用法

compareBoundaryPoints() 方法比较两个范围的位置。

语法：

compareBoundaryPoints(how,sourceRange)

参数

返回值

如果当前范围的指定边界点位于 sourceRange 指定的边界点之前，则返回 -1。如果指定的两个边界点相同，则返回 0。如果当前范围的边界点位于 sourceRange 指定的边界点之后，则返回 1。

抛出

如果 sourceRange 表示的文档不同于当前范围表示的文档，该方法将抛出代码为 WRONG_DOCUMENT_ERR 的 DOMException 异常。

描述

该方法将比较当前范围的边界点和指定的 sourceRange 的边界点，并返回一个值，声明它们在源文档中的相对位置。参数 how 指定了比较两个范围的哪个边界点。该参数的合法值和它们的含义如下：

• Range.START_TO_START - 比较两个 Range 节点的开始点
• Range.END_TO_END - 比较两个 Range 节点的结束点
• Range.START_TO_END - 用 sourceRange 的开始点与当前范围的结束点比较
• Range.END_TO_START - 用 sourceRange 的结束点与当前范围的开始点比较

该方法的返回值是一个数字，声明了当前范围相对于 sourceRange 的位置。因此，您可能认为，首先需要用参数 how 的范围常量指定当前范围的边界点，然后再用它指定 sourceRange 的边界点。但事实上，常量 Range.START_TO_END 指定与当前范围的 end 点和 sourceRange 的 start 点进行比较。同样，常量 Range.END_TO_START 指定比较当前范围的 start 点和指定范围的 end 点。