Selection.selectAllChildren()

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
HTML Editing APIs
The definition of 'Selection.selectAllChildren()' in that specification.
Editor's Draft Initial definition
Selection API
The definition of 'Selection.selectAllChildren()' in that specification.
Working Draft Current definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
selectAllChildren
Experimental
Chrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.

See also