Selection: selectAllChildren() method

{{ ApiRef("DOM") }}

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 ({{jsxref("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

{{EmbedLiveSample("Examples", 700, 200)}}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("Selection")}}, the interface it belongs to.