HTMLSlotElement: assignedNodes() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
TheassignedNodes() method of theHTMLSlotElement interface returns a sequence of the nodes assigned to this slot.
If theflatten option is set totrue, it returns a sequence of both the nodes assigned to this slot, as well as the nodes assigned to any other slots that are descendants of this slot. If no assigned nodes are found, it returns the slot's fallback content.
In this article
Syntax
assignedNodes()assignedNodes(options)Parameters
optionsOptionalAn object that sets options for the nodes to be returned. The available options are:
flattenA boolean value indicating whether to return the assigned nodes of any available child
<slot>elements (true) or not (false). Defaults tofalse.
Return value
An array of nodes.
Examples
The following snippet is taken from ourslotchange example (See it live).
let slots = this.shadowRoot.querySelectorAll("slot");slots[1].addEventListener("slotchange", (e) => { let nodes = slots[1].assignedNodes(); console.log( `Element in Slot "${slots[1].name}" changed to "${nodes[0].outerHTML}".`, );});Here we grab references to all the slots, then add a slotchange event listener to the2nd slot in the template — which is the one that keeps having its contents changed inthe example.
Every time the element inserted in the slot changes, we log a report to the consolesaying which slot has changed, and what the new node inside the slot is.
Specifications
| Specification |
|---|
| HTML> # dom-slot-assignednodes-dev> |