Firefox Tomorrow

web api instance method

Selection: selectAllChildren() method

View on MDN ↗

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>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

Interactive exampleOpen the canonical MDN source to run this embedded demo.

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also