compareBoundaryPoints() 方法比较两个范围的位置。
compareBoundaryPoints(how,sourceRange)
参数 | 描述 |
---|---|
how | 声明如何执行比较操作(即比较哪些边界点)。它的合法值是 Range 接口定义的常量。 |
sourceRange | 要与当前范围进行比较的范围。 |
如果当前范围的指定边界点位于 sourceRange 指定的边界点之前,则返回 -1。如果指定的两个边界点相同,则返回 0。如果当前范围的边界点位于 sourceRange 指定的边界点之后,则返回 1。
如果 sourceRange 表示的文档不同于当前范围表示的文档,该方法将抛出代码为 WRONG_DOCUMENT_ERR 的 DOMException 异常 。
该方法将比较当前范围的边界点和指定的 sourceRange 的边界点,并返回一个值,声明它们在源文档中的相对位置。参数 how 指定了比较两个范围的哪个边界点。该参数的合法值和它们的含义如下:
该方法的返回值是一个数字,声明了当前范围相对于 sourceRange 的位置。因此,您可能认为,首先需要用参数 how 的范围常量指定当前范围的边界点,然后再用它指定 sourceRange 的边界点。但事实上,常量 Range.START_TO_END 指定与当前范围的 end 点和 sourceRange 的 start 点进行比较。同样,常量 Range.END_TO_START 指定比较当前范围的 start 点和指定范围的 end 点。