Document: getSelection() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年11月以降、すべてのブラウザーで利用可能です。
getSelection() は Document インターフェイスのメソッドで、ユーザーが選択したテキストの範囲、またはキャレットの現在位置を表す Selection オブジェクトを返します。
構文
js
getSelection()
引数
なし。
返値
Selection オブジェクト。
例
Selection オブジェクトを取得
js
let selection = document.getSelection();
let selRange = selection.getRangeAt(0);
// この範囲に対して何かをする
console.log(selection); // Selection オブジェクト
Selection オブジェクトの文字列表現
JavaScript では、オブジェクトが文字列を取る関数 (Window.alert() など) に渡された場合、オブジェクトの toString() メソッドが呼び出され、関数にその返値が渡されます。これにより、プロパティやメソッドを持つ実際のオブジェクトであった場合、他の関数に使われると文字列になって現れることがあります。
js
alert(selection);
ただし、すべての関数で自動的に toString() が呼び出されるとは限りません。 Selection オブジェクトを文字列として使用する場合は、 toString() メソッドを直接呼び出してください。
js
let selectedText = selection.toString();
関連するオブジェクト
Window.getSelection() を呼び出すと、 Document.getSelection() と同等の動作をします。
Firefox において現在は getSelection() は <input> 要素の中では動作しないことに注意してください。 HTMLInputElement.setSelectionRange() を使用することで回避できます。
selection と focus との違いにも注意してください。 Document.activeElement はフォーカスを持つ要素を返します。
仕様書
| 仕様書 |
|---|
| Selection API # dom-document-getselection |