L'arbre de l'ombre (Shadow tree)

Un arbre de l'ombre, ou arbre fantôme selon les usages, en anglais shadow tree, est un ensemble caché de nœuds du DOM dont le nœud supérieur est une racine de l'ombre (shadow root en anglais). La racine de l'ombre est le nœud supérieur d'un DOM d'ombre (shadow DOM en anglais) et ne fait pas partie de l'arbre DOM régulier du document.

La racine de l'ombre est attachée à un autre arbre de nœuds via un nœud DOM spécifique appelé son hôte. Cet hôte peut faire partie d'un autre arbre de l'ombre ou de l'arbre DOM régulier. L'arbre de nœuds de l'hôte d'une racine de l'ombre est parfois appelé arbre de lumière (light tree en anglais).

Les nœuds DOM cachés d'un arbre de l'ombre ne sont généralement pas affectés par ce qui est appliqué en dehors de l'arbre de l'ombre, et inversement. La frontière de l'ombre, là où le DOM de l'ombre se termine et où le DOM régulier commence, peut être franchie, mais seulement de façon très intentionnelle :

• Pour manipuler les nœuds d'un arbre de l'ombre depuis l'extérieur, il faut utiliser une API Shadow DOM spéciale.
• La mise en forme d'un arbre de l'ombre depuis l'extérieur peut être réalisée via le ciblage CSS et les parties de l'ombre en CSS.