Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

shadowrootclonable — cloner une racine d’ombre déclarative

L’attribut booléen shadowrootclonable d’un élément template indique qu’une racine d’ombre déclarative peut être clonée. La copie de l’élément hôte peut alors inclure également son arbre d’ombre.

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

Syntaxe

<template shadowrootmode="open" shadowrootclonable>…</template>

shadowrootclonable est un attribut booléen de template, utilisé avec shadowrootmode. Lors de la création d’une racine d’ombre déclarative, l’analyseur définit son indicateur de clonabilité selon la présence de l’attribut. Sans cet attribut, l’indicateur vaut false ; l’attribut seul ne crée pas de racine d’ombre.

Lorsque la racine est clonable, host.cloneNode(true) copie également son arbre d’ombre. Il ne s’agit pas de la copie ordinaire du contenu d’un modèle avec template.content.cloneNode(true) : c’est l’hôte qui est copié avec sa racine d’ombre déjà créée.

La présence active l’option : shadowrootclonable="false" l’active également et ne permet pas de désactiver un attribut booléen. Pour désactiver cette option dans la déclaration, omettez l’attribut. shadowrootclonable ne remplace pas shadowrootserializable : le clonage de nœuds et la sérialisation HTML sont des mécanismes distincts.

L’exemple nécessite un navigateur prenant en charge les racines d’ombre déclaratives et cet attribut. Ouvrez le document HTML complet au lieu d’insérer le balisage avec innerHTML. Le mode open permet d’inspecter la copie avec copy.shadowRoot ; il n’est pas nécessaire d’ajouter l’hôte copié au document.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Shadow root cloning</title>
<div id="host"><template shadowrootmode="open" shadowrootclonable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const copy = host.cloneNode(true);
  document.getElementById('result').textContent =
    copy.shadowRoot?.textContent ?? 'No shadow root';
</script>
</html>

Résultat

Hello

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.

Sources