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

CKTIS / CSS

:scope — l’élément de référence du sélecteur

La pseudo-classe :scope désigne la racine de portée d’un sélecteur. Elle permet, par exemple, de sélectionner les enfants directs de l’élément sur lequel querySelectorAll() est appelé.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

:scope

:scope est une pseudo-classe sans argument qui représente la racine de portée définie par le contexte. Dans panel.querySelectorAll(), l’élément de référence est panel, et non chacun des descendants examinés.

Le sélecteur :scope > .item sélectionne les enfants directs portant la classe item ; :scope .item inclut également les descendants plus éloignés. Dans une feuille de style ordinaire du document, sans portée distincte, :scope correspond à :root. L’utilisation de cette pseudo-classe seule ne crée pas de portée et n’isole pas les styles.

Exemples

const panel = document.createElement('section');
panel.innerHTML = '<p class="item">A</p><div><p class="item">B</p></div>';

const direct = panel.querySelectorAll(':scope > .item');
const nested = panel.querySelectorAll(':scope .item');

console.log(JSON.stringify({
  direct: Array.from(direct, node => node.textContent),
  nested: Array.from(nested, node => node.textContent)
}));

Résultat

{"direct":["A"],"nested":["A","B"]}

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