HTMLSlotElement: assignedElements() 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.

The assignedElements() method of the HTMLSlotElement interface returns a sequence of the elements assigned to this slot (and no other nodes).

If the flatten option is set to true, it returns a sequence of both the elements assigned to this slot, as well as the elements assigned to any other slots that are descendants of this slot. If no assigned elements are found, it returns the slot's fallback content.

Syntax

js
assignedElements()
assignedElements(options)

Parameters

options Optional

An object that sets options for the nodes to be returned. The available options are:

flatten

A boolean value indicating whether to return the assigned elements of any available child <slot> elements (true) or not (false). Defaults to false.

Return value

An array of elements.

Examples

js
let slots = this.shadowRoot.querySelector("slot");
let elements = slots.assignedElements({ flatten: true });

Specifications

Specification
HTML Standard
# dom-slot-assignedelements-dev

Browser compatibility

BCD tables only load in the browser