HTMLSlotElement: assign()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.
Die assign()-Methode der HTMLSlotElement-Schnittstelle setzt die manuell zugewiesenen Knoten des Slots auf eine geordnete Menge von Slottables. Die manuell zugewiesene Knotmenge ist zunächst leer, bis Knoten mit assign() zugewiesen werden.
Hinweis:
Sie können manuelle (imperative) und benannte (deklarative, automatische) Slot-Zuweisungen nicht mischen. Daher muss für diese Methode der Schattenbaum mit der Option slotAssignment: "manual" erstellt worden sein.
Syntax
assign(node1)
assign(node1, node2)
assign(node1, node2, /* …, */ nodeN)
Parameter
Rückgabewert
Keiner (undefined).
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn diese Methode auf einem automatisch zugewiesenen Slot aufgerufen wird.
Beispiele
Im Beispiel unten wird die assign()-Methode verwendet, um die korrekte Registerkarte in einer Registerkartenanwendung anzuzeigen. Die Funktion wird aufgerufen und das Panel übergeben, das angezeigt werden soll. Dieses wird dann dem Slot zugewiesen.
function UpdateDisplayTab(elem, tabIdx) {
const shadow = elem.shadowRoot;
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();
}
}
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-slot-assign |