HTMLSlotElement: assign() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2023.
Theassign() method of theHTMLSlotElement interface sets the slot'smanually assigned nodes to an ordered set of slottables. The manually assigned nodes set is initially empty until nodes are assigned usingassign().
Note:You cannot mix manually (imperative) and named (declarative, automatic) slot assignments. Therefore, for this method to work, the shadow tree needs to have beencreated with theslotAssignment: "manual" option.
Syntax
assign(node1)assign(node1, node2)assign(node1, node2, /* …, */ nodeN)Parameters
Return value
None (undefined).
Exceptions
NotAllowedErrorDOMExceptionThrown when calling this method on an automatically assigned slot.
Examples
In the example below, theassign() method is used to display the correct tab in a tabbed application. The function is called and passed the panel to show, which is then assigned to the slot.
function UpdateDisplayTab(elem, tabIdx) { const shadow = elem.shadowRoot; const slot = shadow.querySelector("slot"); const panels = elem.querySelectorAll("tab-panel"); if (panels.length && tabIdx && tabIdx <= panels.length) { slot.assign(panels[tabIdx - 1]); } else { slot.assign(); }}Specifications
| Specification |
|---|
| HTML # dom-slot-assign |