XML DOM compareBoundaryPoints() 方法

定义和用法

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

语法:

compareBoundaryPoints(how,sourceRange)

参数

参数 描述
how 声明如何执行比较操作(即比较哪些边界点)。它的合法值是 Range 接口定义的常量。
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 点。