Range: compareBoundaryPoints() メソッド
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 の対応する境界点より前か、等しいか、後かを示します。
例外
NotSupportedError
DOMException
-
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);
仕様書
Specification |
---|
DOM Standard # dom-range-compareboundarypoints |
ブラウザーの互換性
BCD tables only load in the browser