CKTIS / HTML
onslotchange — das slotchange-Ereignis behandeln
onslotchange legt einen Handler für das slotchange-Ereignis fest. Im Shadow DOM kann das Ereignis ausgelöst werden, wenn sich die zugewiesenen Knoten ändern oder wenn bei einem Slot ohne zugewiesene Knoten ein direktes Kind hinzugefügt oder entfernt wird.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
HTML: <slot onslotchange="handleChange(event)"></slot>
JavaScript: slot.onslotchange = (event) => { /* handle change */ };onslotchange ist ein globales HTML-Ereignisbehandlungsattribut für slotchange; dazu gehört eine gleichnamige JavaScript-Eigenschaft. Es wird üblicherweise auf einem slot-Element im Shadow DOM verwendet. Das Attribut selbst erstellt weder einen Slot noch weist es ihm Inhalte zu.
Das Ereignis kann ausgelöst werden, wenn sich die zugewiesenen Knoten ändern, etwa wenn ein passender Kindknoten des Hosts hinzugefügt oder entfernt wird. Sind dem Slot keine Knoten zugewiesen, kann auch das Hinzufügen oder Entfernen eines direkten Kindknotens des Slots (als Teil seines Ersatzinhalts) das Ereignis auslösen. Die Liste der zugewiesenen Knoten bleibt dabei leer. Das Ereignis ist keine allgemeine Benachrichtigung über Änderungen innerhalb eines bereits zugewiesenen Elements. Die aktuelle Zuweisung lässt sich mit assignedNodes() oder assignedElements() auslesen.
Der Attributwert ist JavaScript-Code. Im Handler beziehen sich event und this auf das Ereignis beziehungsweise das Element, das den Handler ausführt. Die Zuweisung einer Funktion an die Eigenschaft onslotchange ersetzt den vorherigen Handler; mit addEventListener('slotchange', handler) lassen sich unabhängige Listener hinzufügen. Eine CSP-Richtlinie kann Code in Attributen blockieren.
Das Beispiel erstellt einen Standard-Slot und fügt dem Host ein untergeordnetes Element hinzu. Die Verarbeitung ist asynchron: Prüfe das Ergebnis nach der Zustellung des Ereignisses, nicht unmittelbar nach append().
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>onslotchange example</title>
<div id="host"></div>
<pre id="result">Waiting</pre>
<script>
const host = document.getElementById('host');
const result = document.getElementById('result');
const root = host.attachShadow({ mode: 'open' });
root.innerHTML = '<slot onslotchange="document.getElementById(\'result\').textContent = this.assignedNodes().length"></slot>';
const item = document.createElement('span');
item.textContent = 'Hello';
host.append(item);
</script>Ergebnis
1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.