Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onslotchange — obsluha události slotchange

onslotchange určuje obsluhu události slotchange. V Shadow DOM může tato událost nastat při změně uzlů přiřazených ke slotu nebo při přidání či odebrání přímého potomka slotu bez přiřazených uzlů.

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

Syntaxe

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

onslotchange je globální atribut HTML pro obsluhu události slotchange, kterému odpovídá stejnojmenná vlastnost JavaScriptu. Obvykle se používá na prvku slot v Shadow DOM. Samotný atribut slot nevytváří ani mu nepřiřazuje obsah.

Událost může nastat při změně přiřazených uzlů, například když se přidá nebo odebere odpovídající potomek hostitele. Pokud slot nemá přiřazené žádné uzly, může událost vyvolat i přidání nebo odebrání přímého potomka slotu, který je součástí jeho náhradního obsahu. Seznam přiřazených uzlů přitom zůstává prázdný. Nejde o obecné upozornění na změny uvnitř již přiřazeného prvku. Aktuální přiřazení lze zjistit pomocí assignedNodes() nebo assignedElements().

Hodnotou atributu je kód JavaScriptu. V obsluze označují event a this postupně událost a obsluhující prvek. Přiřazení funkce vlastnosti onslotchange nahradí předchozí obsluhu; addEventListener('slotchange', handler) umožňuje přidat nezávislé posluchače. Zásady CSP mohou blokovat kód v atributech.

Příklad vytvoří výchozí slot a přidá jeho hostiteli jednoho potomka. Zpracování je asynchronní: výsledek ověřte až po doručení události, nikoli ihned po append().

Příklady

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

Výsledek

1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje