درس‌های انتخابی
برنامه‌نویسی
XML DOM compareBoundaryPoints()
تعریف و استفاده
آموزش: compareBoundaryPoints()howcompareBoundaryPoints(sourceRange,
)
| ) | 描述 |
|---|---|
| how | پارامتر |
| sourceRange | درباره این که چگونه عمل مقایسه را انجام دهیم (یعنی کدام نقطه مرزی مقایسه می‌شود) اطلاع می‌دهد. ارزش‌های مجاز آن‌ها ثابت‌های تعریف شده در رابط Range است. |
با محدوده‌ای که باید با محدوده فعلی مقایسه شود. ارزش‌های مجاز آن‌ها ثابت‌های تعریف شده در رابط Range است.
برگشت‌دهی sourceRange اگر نقطه مرزی مشخص شده محدوده فعلی در sourceRange نقطه مرزی مشخص شده بعد از آن، 1 برمی‌گرداند. اگر نقطه مرزی مشخص شده قبل از آن باشد، -1 برمی‌گرداند. اگر دو نقطه مرزی مشخص شده یکسان باشند، 0 برمی‌گرداند. اگر نقطه مرزی فعلی محدوده در
تا
اگر 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 点。
