Selection.selectAllChildren() - Web APIs

Experimental

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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

Syntax

sel.selectAllChildren(parentNode)

Parameters

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

Example

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

const button = document.querySelector('button');
const footer = document.querySelector('footer');

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

Result

Specifications

Specification	Status	Comment
Selection API The definition of 'Selection.selectAllChildren()' in that specification.	Working Draft	Current definition

Browser compatibility

BCD tables only load in the browser