このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Selection: selectAllChildren() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

Selection.selectAllChildren() メソッドは、指定されたノードのすべての子ノードを選択範囲に追加します。それまでの選択範囲は失われます。

構文

js
selectAllChildren(parentNode)

引数

parentNode

parentNode のすべての子要素が選択されます。parentNode 自体は選択対象には含まれません。

返値

なし (undefined)。

HTML

html
<main>
  <button>フッターを選択</button>
  <p>私のウェブサイトへようこそ。</p>
  <p>ご来訪をお楽しみいただければ幸いです。</p>
</main>
<footer>
  <address>webmaster@example.com</address>
  <p>© 2019</p>
</footer>

JavaScript

js
const button = document.querySelector("button");
const footer = document.querySelector("footer");

button.addEventListener("click", (e) => {
  window.getSelection().selectAllChildren(footer);
});

結果

仕様書

仕様書
Selection API
# dom-selection-selectallchildren

ブラウザーの互換性

関連情報

  • 所属先のインターフェイスである Selection