CKTIS / HTML
onslotchange — gérer l’événement slotchange
onslotchange définit un gestionnaire pour l’événement slotchange. Dans le Shadow DOM, cet événement peut se déclencher lorsque les nœuds affectés à un slot changent ou lorsqu’un enfant direct est ajouté à un slot sans nœuds affectés ou en est retiré.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
HTML: <slot onslotchange="handleChange(event)"></slot>
JavaScript: slot.onslotchange = (event) => { /* handle change */ };onslotchange est un attribut global de gestion d’événement HTML associé à slotchange, auquel correspond une propriété JavaScript du même nom. Il s’utilise généralement sur un élément slot dans le Shadow DOM. L’attribut ne crée pas lui-même de slot et ne lui affecte aucun contenu.
L’événement peut se déclencher lorsque les nœuds affectés changent, par exemple à l’ajout ou au retrait d’un enfant de l’hôte qui correspond au slot. Si aucun nœud n’est affecté au slot, l’ajout ou le retrait d’un enfant direct du slot (qui fait partie de son contenu de repli) peut aussi déclencher l’événement, même si la liste des nœuds affectés reste vide. L’événement ne constitue pas une notification générale des changements à l’intérieur d’un élément déjà affecté. Consultez l’affectation actuelle avec assignedNodes() ou assignedElements().
La valeur de l’attribut est du code JavaScript. Dans le gestionnaire, event et this désignent respectivement l’événement et l’élément qui gère celui-ci. Affecter une fonction à la propriété onslotchange remplace le gestionnaire précédent ; addEventListener('slotchange', handler) permet d’ajouter des écouteurs indépendants. Une politique CSP peut bloquer le code défini dans les attributs.
L’exemple crée un slot par défaut et ajoute un enfant à son hôte. Le traitement est asynchrone : vérifiez le résultat après la distribution de l’événement, et non immédiatement après append().
Exemples
<!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>Résultat
1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.