HTMLTemplateElement: shadowRootSlotAssignment-Eigenschaft

Eingeschränkt verfügbar

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

Die shadowRootSlotAssignment-Eigenschaft des HTMLTemplateElement-Interfaces zeigt an, ob das Element so konfiguriert wurde, dass es benannte oder unbenannte Slot-Zuweisungen verwendet.

Diese Eigenschaft kann verwendet werden, um die Unterstützung für das deklarative Attribut zu erkennen auf dem <template>-Element.

Die Eigenschaft kann nicht gelesen werden, um die Slot-Zuweisungsmethode eines Shadow-Roots zu bestimmen. Dies liegt daran, dass eine <template>-Elementdeklaration entweder zur Erstellung eines HTMLTemplateElement oder eines ShadowRoot führt. Wenn ein Shadow-Root erstellt wird, dann nicht das HTMLTemplateElement, sodass es nicht zur Überprüfung der Slot-Zuweisung verwendet werden kann. Wenn ein HTMLTemplateElement erstellt wird, ist es kein Shadow-Root und kann nicht einfach in eines 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

Feature-Erkennung für `shadowrootslotassignment`

Wenn Sie deklarativ Shadow-Roots erstellen, die sich auf unbenannte Slot-Zuweisung verlassen, indem Sie <template>-Elemente verwenden, können Sie die Existenz dieser Eigenschaft auf dem HTMLTemplateElement verwenden, um die Unterstützung zu überprüfen. Dies funktioniert, weil die Eigenschaft gleichzeitig mit der unbenannten Zuweisung mit dem "manual"-Wert hinzugefügt wurde.

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

Der Wert von isShadowRootSlotAssignmentSupported könnte dann verwendet werden, um auf das Anfügen des Shadow-Roots mit Element.attachShadow() zurückzugreifen oder um den Benutzer darüber zu informieren, welche Browserversionen sie verwenden müssen.

Beachten Sie, dass, wenn Sie benannte Slot-Zuweisung verwenden, es nicht notwendig ist, die Unterstützung von shadowrootslotassignment zu überprüfen, da benannte Zuweisung standardmäßig unterstützt wird.