DOM
：：Selection インターフェイス
編集：2022.09.25 by T.A.
[Edge]。→
ユーザーが選択したテキストの範囲、またはキャレットの現在の位置を表します。検査や操作のために Selection オブジェクトを取得するには、window.getSelection() を呼び出してください。
ユーザーは、左から右（文書順）または右から左（文書と逆順）に選択することができます。アンカー（anchor）はユーザーが選択を開始した場所、フォーカス（focus）はユーザーが選択を終了した場所である。デスクトップ マウスで選択する場合、アンカーはマウス ボタンを押した場所に置かれ、フォーカスはマウス ボタンを離した場所に置かれます。
Note： アンカーとフォーカスは、選択範囲の開始位置と終了位置と混同しないようにしましょう。アンカーはフォーカスの前に置かれることもあればその逆もあり、選択の方向によって異なります。
- Selection.anchorNode 読取専用
- 選択範囲を開始する Node を返します。選択範囲が文書内に存在しない場合（例：クリックされなかった iframe）には null を返すことがあります。
- Selection.anchorOffset 読取専用
- 選択部分のアンカーの anchorNode 内でのオフセットを表す値を返します。anchorNode がテキストノードであった場合、これはアンカーに先行する anchorNode 内の文字数です。anchorNode が要素であった場合、これはアンカーに先行する anchorNode の子ノードの数です。
- Selection.focusNode 読取専用
- 選択範囲が終了する Node を返します。選択範囲が文書内に存在しない場合（例えば、クリックされなかった iframe 内の場合）には null を返すことがあります。
- Selection.focusOffset 読取専用
- 選択部分のアンカーの focusNode 内でのオフセットを表す値を返します。 focusNode がテキストであった場合、これは focusNode 内でフォーカスに先行する文字数です。 focusNode が要素であった場合、フォーカスの前にある focusNode の子ノードの数を表します。
- Selection.isCollapsed 読取専用
- 選択範囲の始点と終点が同じ位置にあるかどうかを示す論理値を返します。
- Selection.rangeCount 読取専用
- 選択範囲に含まれる範囲の数を返します。
- Selection.type 読取専用
- 現在の選択部分の型を記述した文字列を返します。
- Selection.addRange()
- Range オブジェクトを選択範囲に追加します。
- Selection.collapse()
- 現在の選択範囲をこの点まで折りたたみます。
- Selection.collapseToEnd()
- 選択範囲を終端まで折りたたみます。
- Selection.collapseToStart()
- 選択範囲を先頭まで折りたたみます。
- Selection.containsNode()
- あるノードが選択範囲に含まれるかどうかを示します。
- Selection.deleteFromDocument()
- 選択部分の内容を文書から削除します。
- Selection.extend()
- 選択範囲のフォーカスをこの点に移動させる。
- Selection.getRangeAt()
- 現在選択されている範囲のうちの一つを表す Range オブジェクトを返します。
- Selection.modify() 非標準
- 現在の選択範囲を変更します。
- Selection.removeRange()
- 選択範囲から範囲を削除します。
- Selection.removeAllRanges()
- 選択範囲からすべての範囲を削除します。
- Selection.selectAllChildren()
- 指定されたノードのすべての子ノードを選択範囲に追加します。
- Selection.setBaseAndExtent()
- 指定した 2 つの DOM ノードのすべてまたは一部、およびそれらの間にあるコンテンツを含む範囲を選択範囲に設定します。
- Selection.toString()
- 選択オブジェクトが現在表現している文字列、すなわち現在選択されている文字列を返します。
¶省く
テスト