Selection: deleteFromDocument() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
deleteFromDocument() は Selection インターフェイスのメソッドで、Range.deleteContents() メソッドを選択された Range に対して呼び出します。
構文
js
deleteFromDocument()
引数
なし。
返値
なし (undefined)。
例
この例では、ボタンをクリックすることで、選択されたテキストやノードを削除することができます。ボタンをクリックすると、Window.getSelection() メソッドが選択されたコンテンツを取得し、deleteFromDocument() メソッドによってそれが削除されます。
HTML
html
<p>これらの段落にある要素をいくつかハイライトしてみてください。</p>
<p>
設定が完了したら、下のボタンをクリックして、選択したコンテンツを削除できます。
</p>
<h2>選択されたテキスト／ノードはすべて削除されます。</h2>
<button>選択したテキストを削除</button>
JavaScript
js
let button = document.querySelector("button");
button.addEventListener("click", deleteSelection);
function deleteSelection() {
let selection = window.getSelection();
selection.deleteFromDocument();
}
結果
仕様書
| 仕様書 |
|---|
| Selection API # dom-selection-deletefromdocument |
ブラウザーの互換性
関連情報
- 所属先のインターフェイスである
Selection