Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onslotchange — gestire l’evento slotchange

onslotchange specifica un gestore per l’evento slotchange. In Shadow DOM, l’evento può scattare quando cambiano i nodi assegnati a uno slot o quando si aggiunge o si rimuove un figlio diretto di uno slot senza nodi assegnati.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

HTML: <slot onslotchange="handleChange(event)"></slot>
JavaScript: slot.onslotchange = (event) => { /* handle change */ };

onslotchange è un attributo globale HTML per la gestione dell’evento slotchange, a cui corrisponde una proprietà JavaScript con lo stesso nome. Si usa in genere su un elemento slot in Shadow DOM. L’attributo da solo non crea uno slot e non gli assegna contenuti.

L’evento può scattare quando cambiano i nodi assegnati, per esempio quando viene aggiunto o rimosso un figlio dell’host che corrisponde allo slot. Se lo slot non ha nodi assegnati, anche l’aggiunta o la rimozione di un figlio diretto dello slot (parte del suo contenuto di ripiego) può far scattare l’evento, sebbene l’elenco dei nodi assegnati rimanga vuoto. Non è una notifica generica delle modifiche all’interno di un elemento già assegnato. Per leggere l’assegnazione corrente, usa assignedNodes() o assignedElements().

Il valore dell’attributo è codice JavaScript. Nel gestore, event e this si riferiscono rispettivamente all’evento e all’elemento che lo gestisce. Assegnare una funzione alla proprietà onslotchange sostituisce il gestore precedente; addEventListener('slotchange', handler) consente di aggiungere listener indipendenti. Una policy CSP può bloccare il codice negli attributi.

L’esempio crea uno slot predefinito e aggiunge un figlio al relativo host. La gestione è asincrona: controlla il risultato dopo la consegna dell’evento, non subito dopo append().

Esempi

<!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>

Risultato

1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti