Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

@scope — rozsah selektorů s dolní hranicí

Pravidlo @scope omezuje vnořená pravidla stylu na fragment vymezený kořeny a volitelnými dolními hranicemi.

Verze: 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> } vytvoří samostatný rozsah pro každý prvek nalezený počátečním selektorem. Kořen je zahrnut, zatímco prvek nalezený koncovým selektorem a celý jeho podstrom jsou vyloučeny. Bez počátečního selektoru bývá kořenem rodič uzlu vlastníka stylu. Pseudoprvky nemohou být kořeny ani hranicemi a jediná neplatná položka zneplatní netolerantní seznam selektorů v preambuli.

Vnitřní selektory vybírají jen subjekty, které zůstávají v rozsahu, a jsou ve výchozím stavu relativní ke kořeni. :scope vybírá kořen; & se chová jako :where(:scope), takže nepřidává specificitu. Selektor preambule specificitu vnitřního pravidla nezvyšuje. V kaskádě se nejprve porovná specificita, pak blízkost kořene rozsahu a nakonec pořadí ve zdroji.

Lze tak izolovat komponentu, oblast motivu či fragment bez třídy na každém potomku. Příklad začíná v .card a končí před .nested. Přímý odstavec zezelená, ale odstavec za hranicí a vnější prvek zůstanou černé. Preambule to (.nested) a vlastnosti CSSScopeRule potvrzují obě hranice.

Příklady

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);

Výsledek

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

Pravidlo @scope omezuje vnořená pravidla stylu na fragment vymezený kořeny a volitelnými dolními hranicemi.

Zdroje