The assignedNodes() property of the HTMLSlotElement interface returns the sequence of elements assigned to this slot or, alternatively, the slot's fallback content.
Syntax
var assignedNodes[] = HTMLSlotElement.assignedNodes([options])
Parameters
- options Optional
- An object that sets options for the nodes to be returned. The available options are:
flatten: ABooleanindicating whether to return the elements assigned to the slot (if this value isfalse) or the slot's fallback content (if this value istrue). The default isfalse.
Return value
An array of nodes.
Examples
The following snippet is taken from our slotchange example (see it live also).
let slots = this.shadowRoot.querySelectorAll('slot');
slots[1].addEventListener('slotchange', function(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 the 2nd slot in the template — which is the one that keeps having its contents changed in the example.
Every time the element inserted in the slot changes, we log a report to the console saying which slot has changed, and what the new node inside the slot is.
Specifications
| Specification | Status | Comment |
|---|---|---|
| HTML Living Standard The definition of 'assignedNodes' in that specification. |
Living Standard |
Browser Compatibility
| Desktop | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Basic support | Chrome Full support 53 | Edge
No support
No
| Firefox
Full support
63
| IE No support No | Opera Full support 40 | Safari Full support 10.1 | WebView Android Full support 53 | Chrome Android Full support 53 | Edge Mobile
No support
No
| Firefox Android
Full support
63
| Opera Android Full support 40 | Safari iOS Full support 10.1 | Samsung Internet Android Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.