Selection: selectAllChildren() method

The Selection.selectAllChildren() method adds all the children of the specified node to the selection. Previous selection is lost.

Syntax

js
selectAllChildren(parentNode)

Parameters

parentNode

All children of parentNode will be selected. parentNode itself is not part of the selection.

Return value

None (undefined).

Examples

HTML

html
<main>
  <button>Select Footer</button>
  <p>Welcome to my website.</p>
  <p>I hope you enjoy your visit.</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);
});

Result

Specifications

Specification
Selection API
# dom-selection-selectallchildren

Browser compatibility

BCD tables only load in the browser

See also