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