Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

@scope — zakres selektorów z dolną granicą

Reguła @scope ogranicza dopasowanie zagnieżdżonych reguł stylu do poddrzewa wyznaczonego przez korzeń i opcjonalne granice dolne.

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

Składnia

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

@scope <scope-boundaries>? { <block-contents> } tworzy osobny zakres dla każdego elementu pasującego do selektora początkowego. Korzeń należy do zakresu, natomiast element pasujący do selektora końcowego oraz całe jego poddrzewo są wykluczone. Gdy selektor początkowy zostanie pominięty, korzeniem jest zwykle rodzic węzła będącego właścicielem arkusza. Pseudoelement nie może być korzeniem ani granicą, a listy selektorów w preambule są bezlitosne wobec błędów.

Selektory wewnętrzne dopasowują tylko elementy pozostające w zakresie i są domyślnie względne wobec korzenia. :scope wybiera korzeń; & zachowuje się jak :where(:scope), więc nie dodaje swoistości. Selektor z preambuły nie zwiększa swoistości reguły wewnętrznej. W kaskadzie najpierw porównuje się swoistość, następnie bliskość korzenia zakresu, a dopiero potem kolejność źródłową.

Zakres jest przydatny dla komponentu, motywu albo fragmentu dokumentu bez dopisywania klasy do każdego potomka. Przykład otwiera zakres w .card i kończy go przed .nested. Bezpośredni akapit staje się zielony, lecz akapit za granicą i element zewnętrzny pozostają czarne. Preambuła to (.nested) oraz właściwości obiektu CSSScopeRule potwierdzają obie granice.

Przykłady

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

Wynik

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

Reguła @scope ogranicza dopasowanie zagnieżdżonych reguł stylu do poddrzewa wyznaczonego przez korzeń i opcjonalne granice dolne.

Źródła