Range: setEnd() メソッド
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
Range.setEnd() メソッドは Range の終了位置を指定されたノードの指定されたオフセットに設定します。 終点を始点より上（文書内の高い位置）に設定すると、始点と終点の両方が指定した終点位置に設定された、折りたたまれた範囲になります。
構文
js
setEnd(endNode, endOffset)
引数
返値
なし (undefined)。
例外
InvalidNodeTypeErrorDOMException-
endNodeで指定されたノードは doctype ノードです。範囲の終点は doctype ノード内に配置することはできません。 IndexSizeErrorDOMException-
endOffsetで指定された値は、ノードの長さ以上であるか、 0 未満です。
使用上の注意
endNode が Text、Comment、CDataSection のいずれかの型の Node である場合、 endOffset は endNode の開始位置からの文字数です。他の型の Node である場合、 endOffset は endNode の始点からの子ノードの数を指定します。
例
js
const range = document.createRange();
const endNode = document.getElementsByTagName("p").item(3);
const endOffset = endNode.childNodes.length;
range.setEnd(endNode, endOffset);
メモ:
setEnd() は setStart() と組み合わせて使用するのが一般的です。
仕様書
| Specification |
|---|
| DOM # dom-range-setend |
ブラウザーの互換性
Loading…