Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

@container — zapytanie o kontener przodka

Reguła @container warunkuje style potomka rozmiarem lub stylem wybranego kontenera przodka, dzięki czemu komponent reaguje na miejsce użycia, a nie tylko na viewport.

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

Składnia

@container <container-condition># {
  <block-contents>
}

@container [<container-name>]? <container-condition> { <stylesheet> } jest warunkową regułą grupującą. Dla każdego stylowanego elementu przeglądarka wybiera spośród przodków najbliższy kontener zdolny obsłużyć wszystkie cechy zapytania; opcjonalna nazwa ogranicza kandydatów. Zapytania rozmiaru wymagają container-type: inline-size albo size, natomiast zapytania stylu korzystają z obliczonych wartości kontenera.

W praktyce komponent może zmienić układ, gdy jego własny panel ma dość miejsca, nawet jeśli viewport się nie zmienia. Warunek dotyczy potomków kontenera: element nie może stylować samego siebie na podstawie własnego rozmiaru. Gdy brak odpowiedniego przodka, wynik zapytania jest nieznany i reguły z bloku nie działają. Nazwany kontener pozwala ominąć bliższy, ale niepasujący kontekst.

Łącz and, or i not zgodnie z gramatyką i pamiętaj, że jednostki em w warunku odnoszą się do wartości obliczonej na kontenerze. Zagnieżdżone zapytania mogą wybrać różne kontenery, dlatego nie zawsze wolno je scalać. Przykład ustanawia kontener osi inline, sprawdza stan potomka przy 300 px, następnie zwęża go do 100 px i odczytuje rzeczywistą wartość obliczoną --state.

Przykłady

const style = document.createElement('style');
style.textContent = `.host { container-type: inline-size; width: 300px; }
.target { --state: base; }
@container (inline-size > 200px) { .target { --state: wide; } }`;
document.head.append(style);
const host = document.createElement('div');
host.className = 'host';
host.innerHTML = '<div class="target">card</div>';
document.body.append(host);
const target = host.firstElementChild;
const wide = getComputedStyle(target).getPropertyValue('--state').trim();
host.style.width = '100px';
await new Promise(requestAnimationFrame);
const narrow = getComputedStyle(target).getPropertyValue('--state').trim();
console.log('300px=' + wide + '; 100px=' + narrow);

Wynik

300px=wide; 100px=base

Reguła @container warunkuje style potomka rozmiarem lub stylem wybranego kontenera przodka, dzięki czemu komponent reaguje na miejsce użycia, a nie tylko na viewport.

Źródła