W3cubDocs

/Web APIs

Selection: selectAllChildren() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

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

Syntax

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

<main>
  <button>Select Footer</button>
  <p>Welcome to my website.</p>
  <p>I hope you enjoy your visit.</p>
</main>
<footer>
  <address>[email protected]</address>
  <p>© 2019</p>
</footer>

JavaScript

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

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`selectAllChildren`	1	12	1	≤12.1	3.1	18	4	≤12.1	2	1.0	4.4	2