このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Range: collapse() メソッド

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

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);

仕様書

仕様書
DOM
# dom-range-collapse

ブラウザーの互換性

関連情報