HTMLTemplateElement: shadowRootSlotAssignment-Eigenschaft

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die shadowRootSlotAssignment-Eigenschaft der HTMLTemplateElement-Schnittstelle gibt an, ob das Element so konfiguriert wurde, dass es benannte oder unbenannte Slot-Zuweisung verwendet.

Diese Eigenschaft kann verwendet werden, um die Unterstützung des deklarativen Attributs zu erkennen auf dem <template>-Element.

Die Eigenschaft kann nicht gelesen werden, um die Slot-Zuweisungsmethode eines Schattenwurzel-Elements zu bestimmen. Dies liegt daran, dass eine <template>-Element-Deklaration entweder ein HTMLTemplateElement oder ein ShadowRoot erzeugt. Wenn eine Schattenwurzel erzeugt wird, dann nicht das HTMLTemplateElement, daher können Sie es nicht verwenden, um die Slot-Zuweisung zu überprüfen. Wenn ein HTMLTemplateElement erzeugt wird, ist es keine Schattenwurzel, und es kann nicht einfach in eine umgewandelt werden - daher ist der Wert irrelevant.

Wenn definiert, spiegelt es den Wert des shadowrootslotassignment-Attributs des zugehörigen <template>-Elements wider.

Wert

Ein String, der den Wert des shadowrootslotassignment-Attributs des zugehörigen <template>-Elements widerspiegelt. Mögliche Werte sind "named" und "manual".

Beispiele

Erkennung der Funktion `shadowrootslotassignment`

Wenn Sie Schattenwurzeln deklarativ erstellen, die auf unbenannte Slot-Zuweisung angewiesen sind und <template>-Elemente verwenden, können Sie das Vorhandensein dieser Eigenschaft auf dem HTMLTemplateElement nutzen, um die Unterstützung zu überprüfen. Dies funktioniert, da die Eigenschaft gleichzeitig mit der unbenannten Zuweisung unter Verwendung des Werts "manual" hinzugefügt wurde.

const isShadowRootSlotAssignmentSupported = Object.hasOwn(
  HTMLTemplateElement.prototype,
  "shadowRootSlotAssignment",
);

Der Wert von isShadowRootSlotAssignmentSupported könnte dann verwendet werden, um als Fallback die Schattenwurzel mit Element.attachShadow() anzuhängen oder um den Benutzer darüber zu informieren, welche Browserversionen erforderlich sind.

Beachten Sie, dass es bei der Verwendung von benannter Slot-Zuweisung nicht notwendig ist, die Unterstützung für shadowrootslotassignment zu überprüfen, da die benannte Zuweisung standardmäßig unterstützt wird.