Range: compareBoundaryPoints() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
Range.compareBoundaryPoints() メソッドは、 Range の境界点を別の範囲のものと比較します。
構文
js
compareBoundaryPoints(how, sourceRange)
引数
how-
定数で、比較メソッドを説明します。
Range.END_TO_ENDは sourceRange の終わりの境界点とRangeの終わりの境界点を比較します。Range.END_TO_STARTは sourceRange の終わりの境界点とRangeの始まりの境界点を比較します。Range.START_TO_ENDは sourceRange の始まりの境界点とRangeの終わりの境界点を比較します。Range.START_TO_STARTは sourceRange の始まりの境界点とRangeの始まりの境界点を比較します。
sourceRange-
範囲との境界点を比較するための
Rangeです。
返値
-1, 0, 1 のいずれかの数値で、 Range の対応する境界点が sourceRange の対応する境界点より前か、等しいか、後かを示します。
例外
NotSupportedErrorDOMException-
how引数の値が無効な場合に発生します。
例
js
const range = document.createRange();
range.selectNode(document.querySelector("div"));
const sourceRange = document.createRange();
sourceRange.selectNode(document.getElementsByTagName("div")[1]);
const compare = range.compareBoundaryPoints(Range.START_TO_END, sourceRange);
仕様書
| 仕様書 |
|---|
| DOM # dom-range-compareboundarypoints |