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

CKTIS / CSS

@scope — portée de sélecteurs avec limite basse

La règle @scope limite les règles de style imbriquées à un fragment défini par des racines et des limites basses facultatives.

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

Syntaxe

@scope <scope-boundaries>? {
  <block-contents>
}
<scope-boundaries> = [ [ ( <scope-start> ) ]? [ to ( <scope-end> ) ]? ]!

@scope <scope-boundaries>? { <block-contents> } crée une portée distincte pour chaque élément trouvé par le sélecteur initial. La racine est incluse, tandis qu’un élément trouvé par le sélecteur final et tout son sous-arbre sont exclus. Sans sélecteur initial, la racine est normalement le parent du nœud propriétaire de la feuille. Un pseudo-élément ne peut être ni racine ni limite, et une entrée invalide fait échouer les listes de sélecteurs non tolérantes de la préambule.

Les sélecteurs internes ne visent que les sujets encore dans la portée et sont relatifs à la racine par défaut. :scope désigne la racine ; & se comporte comme :where(:scope) et n’ajoute donc aucune spécificité. Le sélecteur de préambule n’augmente pas celle d’une règle interne. Dans la cascade, on compare d’abord la spécificité, puis la proximité de la racine et enfin l’ordre de source.

Un composant, une zone de thème ou un fragment peut ainsi être isolé sans classe sur chaque descendant. L’exemple commence à .card et s’arrête avant .nested. Le paragraphe direct devient vert, mais celui au-delà de la limite et l’élément extérieur restent noirs. La préambule to (.nested) et les propriétés de CSSScopeRule confirment les deux limites.

Exemples

const style = document.createElement('style');
style.textContent = `p { color: rgb(0 0 0); }
@scope (.card) to (.nested) { p { color: rgb(0 128 0); } }`;
document.head.append(style);
const card = document.createElement('section');
card.className = 'card';
card.innerHTML = '<p class="direct">direct</p><div class="nested"><p class="limited">limited</p></div>';
const outside = document.createElement('p');
outside.textContent = 'outside';
document.body.append(card, outside);
const rule = style.sheet.cssRules[1];
console.log('rule=' + rule.constructor.name + '; start=' + rule.start + '; end=' + rule.end + '; direct=' + getComputedStyle(card.querySelector('.direct')).color + '; limited=' + getComputedStyle(card.querySelector('.limited')).color + '; outside=' + getComputedStyle(outside).color);

Résultat

rule=CSSScopeRule; start=.card; end=.nested; direct=rgb(0, 128, 0); limited=rgb(0, 0, 0); outside=rgb(0, 0, 0)

La règle @scope limite les règles de style imbriquées à un fragment défini par des racines et des limites basses facultatives.

Sources