HTMLTemplateElement: shadowRootSlotAssignment Eigenschaft

Eingeschränkt verfügbar

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

Vollständige Kompatibilität anzeigen
Mehr erfahren

Die shadowRootSlotAssignment-Eigenschaft des HTMLTemplateElement-Interface zeigt an, ob das Element so konfiguriert wurde, dass es benannte oder unbenannte Slot-Zuweisung 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 ausgelesen werden, um die Methode der Slot-Zuweisung eines Schattenwurzel-Elementes zu bestimmen. Das liegt daran, dass eine <template>-Elementdeklaration entweder zu der Erstellung eines HTMLTemplateElement oder eines ShadowRoot führt. Wenn eine Schattenwurzel erstellt wird, dann gibt es kein HTMLTemplateElement, sodass Sie es nicht verwenden können, um die Slot-Zuweisung zu überprüfen. Wenn ein HTMLTemplateElement erstellt wird, dann ist es keine Schattenwurzel und 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 Unterstützung für `shadowrootslotassignment`

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

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

Der Wert von isShadowRootSlotAssignmentSupported könnte dann verwendet werden, um auf das Anhängen der Schattenwurzel mit Element.attachShadow() zurückzufallen oder um den Benutzer darüber zu informieren, welche Browserversionen verwendet werden müssen.

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