CKTIS / HTML
onslotchange — obsługa zdarzenia slotchange
onslotchange określa procedurę obsługi zdarzenia slotchange. W Shadow DOM zdarzenie to może wystąpić po zmianie przypisanych węzłów lub po dodaniu bądź usunięciu bezpośredniego dziecka slotu, gdy nie przypisano mu żadnych węzłów.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
HTML: <slot onslotchange="handleChange(event)"></slot>
JavaScript: slot.onslotchange = (event) => { /* handle change */ };onslotchange jest globalnym atrybutem HTML obsługującym zdarzenie slotchange; odpowiada mu właściwość JavaScript o tej samej nazwie. Zwykle używa się go na elemencie slot w Shadow DOM. Sam atrybut nie tworzy slotu ani nie przypisuje mu zawartości.
Zdarzenie może wystąpić po zmianie przypisanych węzłów, na przykład po dodaniu lub usunięciu pasującego dziecka hosta. Jeśli slot nie ma przypisanych węzłów, zdarzenie może też wystąpić po dodaniu lub usunięciu bezpośredniego dziecka slotu, stanowiącego jego zawartość zastępczą. Lista przypisanych węzłów pozostaje wtedy pusta. Nie jest to ogólne powiadomienie o zmianach wewnątrz już przypisanego elementu. Bieżące przypisanie można odczytać przez assignedNodes() lub assignedElements().
Wartością atrybutu jest kod JavaScript. W procedurze dostępne są event oraz this, wskazujące odpowiednio zdarzenie i element obsługujący. Przypisanie funkcji do właściwości onslotchange zastępuje poprzednią procedurę; addEventListener('slotchange', handler) pozwala dodawać niezależne procedury. Polityka CSP może blokować kod w atrybutach.
Przykład tworzy domyślny slot i dodaje jedno dziecko hosta. Obsługa jest asynchroniczna: wynik należy sprawdzić po dostarczeniu zdarzenia, nie bezpośrednio po append().
Przykłady
<!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>Wynik
1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.