Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes