Range: collapse() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Range.collapse() メソッドは、 Range を境界点の一つに折りたたみます。

折りたたまれた Range は空で、コンテンツを含まず、 DOM ツリーの単一の点を指定します。 Range が既に折りたたまれているかどうかを調べるには、 Range.collapsed プロパティを参照してください。

構文

js
collapse()
collapse(toStart)

引数

toStart 省略可

論理値です。 true の場合は Range を先頭側に、false の場合は末尾側に折りたたみます。省略すると既定で false となります。

返値

なし (undefined)。

例

js
const range = document.createRange();

const referenceNode = document.getElementsByTagName("div").item(0);
range.selectNode(referenceNode);
range.collapse(true);

仕様書

Specification
DOM Standard
# dom-range-collapse

ブラウザーの互換性

BCD tables only load in the browser

関連情報