CKTIS / HTML
onslotchange — processar o evento slotchange
onslotchange especifica um processador para o evento slotchange. No Shadow DOM, o evento pode ser desencadeado quando mudam os nós atribuídos a um slot ou quando se adiciona ou remove um filho direto de um slot sem nós atribuídos.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
HTML: <slot onslotchange="handleChange(event)"></slot>
JavaScript: slot.onslotchange = (event) => { /* handle change */ };onslotchange é um atributo global de HTML para processar o evento slotchange, com uma propriedade JavaScript correspondente com o mesmo nome. É normalmente utilizado num elemento slot no Shadow DOM. O atributo, por si só, não cria um slot nem lhe atribui conteúdo.
O evento pode ser desencadeado quando mudam os nós atribuídos, por exemplo, quando se adiciona ou remove um filho do anfitrião que corresponde ao slot. Se o slot não tiver nós atribuídos, adicionar ou remover um filho direto do slot (parte do seu conteúdo alternativo) também pode desencadear o evento, embora a lista de nós atribuídos se mantenha vazia. Não é uma notificação geral de alterações dentro de um elemento já atribuído. Consulta a atribuição atual através de assignedNodes() ou assignedElements().
O valor do atributo é código JavaScript. No processador, event e this referem-se, respetivamente, ao evento e ao elemento que o processa. Atribuir uma função à propriedade onslotchange substitui o processador anterior; addEventListener('slotchange', handler) permite adicionar escutadores independentes. Uma política CSP pode bloquear código nos atributos.
O exemplo cria um slot predefinido e adiciona um filho ao respetivo anfitrião. O processamento é assíncrono: verifica o resultado depois de o evento ser entregue, e não imediatamente após append().
Exemplos
<!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>Resultado
1
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.