大网数据广告活动
Web 标准与前端开发

ShadowRoot: slotAssignment property

· 52CE 我爱测

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`).

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 slot attribute that matches the name attribute of a <slot> within this shadow root will be assigned to that slot. Any top-level children of the host with no slot attribute will be assigned to a <slot> with no name attribute (the "default slot"), if one is present.
  • 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()
  • shadowrootslotassignment attribute of the <template> element
  • HTMLTemplateElement.shadowRootSlotAssignment

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。