Shadow DOM
The read-only slotAssignment property of the ShadowRoot interface returns the slot assignment mode for the shadow DOM tree. Nodes are either automatically assigned based on name matching (named) or manually assigned (manual).
The value of this property is defined using the slotAssignment option when calling Element.attachShadow(), or using the shadowrootslotassignment attribute on a template element when declaratively creating a shadow root.
Value
A string that can be one of:
named- : Elements are automatically assigned to slot elements within this shadow root.
Any top-level children of the host with a
slotattribute that matches thenameattribute of a<slot>within this shadow root will be assigned to that slot. Any top-level children of the host with noslotattribute will be assigned to a<slot>with nonameattribute (the "default slot"), if one is present.
- : Elements are automatically assigned to slot elements within this shadow root.
Any top-level children of the host with a
manual- : Elements are not automatically assigned to slot elements. Instead, they must be manually assigned with HTMLSlotElement.assign().
Examples
Basic usage
In the example below, the assign() 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.
We test if the slotAssignment is named to prevent an exception from being raised when HTMLSlotElement.assign() is called.
function UpdateDisplayTab(elem, tabIdx) {
const shadow = elem.shadowRoot;
// This test is usually not needed, but can be useful when debugging
if (shadow.slotAssignment === "named") {
console.error(
"Trying to manually assign a slot on an automatically-assigned (named) slot",
);
}
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
Browser compatibility
See also
- Element.attachShadow()
- HTMLSlotElement.assign()
shadowrootslotassignmentattribute of the<template>element- HTMLTemplateElement.shadowRootSlotAssignment
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
