Selection API
メモ:
この API は Web Workers では 使用できません。(WorkerNavigator
経由では公開されていません)
Selection API は、開発者がドキュメントのユーザーに選択されている部分にアクセスしたり操作したりできるようにします。
Window.getSelection()
および Document.getSelection()
メソッドは、ドキュメントのユーザーに選択されている部分を表す Selection
オブジェクトを返します。Selection
オブジェクトは、以下を行うメソッドを提供します。
- 現在選択されているノードにアクセスする。
- 現在の選択を変更する。選択を伸ばしたり、縮めたり、ドキュメントのまったく異なる部分を選択したりする。
- DOM から現在選択されている部分を削除する。
Selection API は、Document
で発火する 2 種類のイベントも提供します。
selectstart
イベントは、ユーザーが新しく選択を開始したとき発火します。selectionchange
イベントは、現在の選択範囲が変更されたとき発火します。
インターフェイス
Selection
-
ドキュメントのユーザーによって選択されている部分、またはキャレットの現在の位置を表すインターフェイスです。
Document.getSelection()
-
現在の選択範囲、またはキャレットの現在の位置を表す
Selection
オブジェクトを返すメソッドです。 Window.getSelection()
-
現在の選択範囲、またはキャレットの現在の位置を表す
Selection
オブジェクトを返すメソッドです。 Document.selectionchange
-
現在の選択範囲が変更されたとき発火するイベントです。
Node.selectstart
-
ユーザーが新しく選択を開始したとき発火するイベントです。
仕様書
Specification |
---|
Selection API # selection-interface |