Strony internetowe i programowanie

Zapytania kontenerów CSS w 2026: Twórz responsywne komponenty bez punktów przerwania widoku

CSS Container Queries in 2026: Build Responsive Components Without Viewport Breakpoints

Dowiedz się, jak zapytania kontenerów CSS pozwalają komponentom responsywnym dostosować się do dostępnej przestrzeni zamiast do widoku przeglądarki. Twórz wielokrotnego użytku karty, korzystaj z nazwanych kontenerów i jednostek kontenerowych oraz unikaj typowych problemów z układem i kompatybilnością.

Zapytania kontenerowe CSS w 2026: Twórz responsywne komponenty bez punktów przełamu widoku

Responsywny projekt stron tradycyjnie opiera się na zapytaniach mediowych. Deweloperzy wybierają punkty przełamu widoku i dostosowują układ dla telefonów, tabletów i komputerów stacjonarnych. To nadal dobrze działa na poziomie układów stron, ale nowoczesne komponenty często pojawia się w wielu kontekstach: sekcje na pełną szerokość, wąskie sidebarze, dashboardy, modale i siatki.

Karta na pulpicie o szerokości 1440 pikseli może mieć tylko 280 pikseli dostępnych w sidebarze. Punkt przełamu widoku nie może niezawodnie opisać przestrzeni tego komponentu.

Zapytania kontenerowe CSS pozwalają komponentom reagować na rozmiar odpowiedniego przodka, a nie tylko na widok. To czyni je szczególnie przydatnymi w ponownie wykorzystywalnych systemach projektowania, motywach blokowych WordPress, modułach Joomla i kreatorach stron.

Czym są zapytania kontenerowe CSS?

Zapytanie kontenerowe rozmiaru ocenia wymiary wyznaczonego kontenera przodka. Komponent może zmieniać swoje wewnętrzny układ, gdy dostępna dla niego przekroczy próg.

Na przykład, karta może wyświetlać swoje obrazek nad tekstem, gdy jest wąska, ale przesuwa obrazek obok tekstu, gdy jej kontener ma co najmniej 480 pikseli szerokości.

Zapytania mediowe pozostają przydatne do nawigacji na poziomie stron i preferencji urządzeń. Zapytania kontenerowe resolved osobny problem responsywności na poziomie komponentu.

Zapytania mediowe vs. zapytania kontenerowe: Porównanie wizualne i live demo

Ilustracja porównuje dwa podejścia. Przesuń suwak, aby zmienić dostępną szerokość karty. Demonstracja wykorzystuje prawdziwe zapytanie kontenerowe CSS, a nie przełączający układ sterowany JavaScript.

Media queries vs. container queries

Media query

Responds to browser viewport width.

Container query

Responds to available component space.

Try the 480px container breakpoint

520px
Building Better Web Components

A reusable card that adapts to the space available.

Read the guide

Horizontal layout at 520px

Move the slider to change the container width. The card switches layout at 480px. On narrow screens the maximum width is limited to the available space.

Punkt przełamu należy do projektu komponentu, a nie do konkretnej kategorii urządzenia. Na wąskim ekranie telefonu, demo ogranicza kontener do dostępnej szerokości widoku.

Krok 1: Stwórz semantyczną kartę

Zacznij od karty, która może pojawić się na liście articułów, rekomendacji produktu lub indeksie dokumentacji:

<div class="card-container">
    <article class="content-card">
        <img class="content-card__image"
             src="/images/example.webp"
             alt="A laptop on a desk"
             width="640" height="400">
        <div class="content-card__body">
            <h2>Building Better Web Components</h2>
            <p>Learn how modern CSS makes layouts more reusable.</p>
            <a href="/guide">Read the guide</a>
        </div>
    </article>
</div>

Zewnętrzny element stanie się zapytaniem konteneru. Wewnętrzny article jest potomkiem, którego prezentacja się zmienia.

To rozróżnienie jest ważne: zapytanie kontenerowe rozmiaru nie styluje samego pytанego elementu. Ono ociera kontener przodka i styluje pasujące potomki.

Krok 2: Napisz odporny domyślny układ

Zacznij od układu, który pozostaje użyteczny bez zapytań kontenerów:

.card-container {
    width: 100%;
}

.content-card {
    display: grid;
    grid-template-columns: minmax(0, 1fr);
    gap: 1rem;
    padding: 1rem;
    border: 1px solid #d9dee5;
    border-radius: 12px;
    background: #fff;
}

.content-card__image {
    display: block;
    width: 100%;
    height: auto;
    aspect-ratio: 8 / 5;
    object-fit: cover;
    border-radius: 8px;
}

.content-card__body {
    min-width: 0;
}

Domyślny układ obrazek-nad-tekstem działa w wąskich przestrzeniach. minmax(0, 1fr) siatka track i min-width: 0 zmniejszają ryzyko przelewania się długiej zawartości.

Krok 3: Ogłosz zapytanie konteneru

Użyj właściwości container-type:

.card-container {
    container-type: inline-size;
}

Wartość inline-size włącza zapytania rozmiaru wzdłuż osi inline, która zazwyczaj odpowiada szerokości w trybach pisania poziomego.

Możesz również napotkać:

.card-container {
    container-type: size;
}

Wartość size obsuguje obie osie, ale wprowadza silniejsze wymagania zawartości. Dla majority responsywnych kart, inline-size jest praktyczniejszym domyślnym.

Zawartość jestważna, ponieważ przeglądarki muszą być w stanie obliczyć rozmiar konteneru bez okrężnych zależności od stylów potomków.

Krok 4: Dodaj regułę responsywną

Teraz zmień wewnętrzny układ tylko wtedy, gdy kontener przodka jest wystarczająco szeroki:

Illustration of the article's main concept
@container (min-width: 480px) {
    .content-card {
        grid-template-columns: 180px minmax(0, 1fr);
        align-items: center;
    }

    .content-card__image {
        height: 100%;
    }
}

Szeroki sidebar na pulpit o szerokości tylko 300 pikseli zachowuje układ stosu. Karta w kolumnie zawartości o szerokości 600 pikseli staje się pozioma, nawet jeśli widok nie jest szczególnie szeroki.

To jest główny benefit: komponent odpowiada na swoją własną dostępną przestrzeń.

Krok 5: Użyj nazwanych kontenerów dla złożonych układów

W dashboardzie lub szablonie CMS, komponent może mieć kilka zagnieżdżonych kontenerów. Domyślnie, zapytanie rozmiaru znajduje najbliższego odpowiedniego przodka.

Nazwij zamierzony kontener, gdy potrzebujesz więcej kontroli:

.article-list-item {
    container: article-card / inline-size;
}

@container article-card (min-width: 480px) {
    .content-card {
        grid-template-columns: 180px minmax(0, 1fr);
    }
}

Skróć container definije zarówno nazwę, jak i typ. Nazwanie pomaga zapobiec niepowiązanemu zagnieżdżonemu kontenerowi stanie się celem zapytania.

Krok 6: Użyj jednostek względnych konteneru

CSS obejmuje jednostki długości oparte na odpowiednim kontenerze zapytania:

Jednostka Znaczenie
cqw 1% szerokości konteneru
cqh 1% wysokości konteneru
cqi 1% rozmiaru inline konteneru
cqb 1% rozmiaru block konteneru
cqmin Mniejszy z cqi i cqb
cqmax Większy z cqi i cqb

Dla płynnej typografii komponentu:

.card-container {
    container: article-card / inline-size;
}

.content-card h2 {
    font-size: clamp(1.1rem, 4cqi, 1.8rem);
}

W przeciwieństwie do vw, cqi może skalować tekst wraz z kontenerem komponentu. Zawsze testuj czytelność, powiększenie przeglądarki i długie przetłumaczone nagłówki. Jeśli nie istnieje odpowiedni kontener, jednostki względne konteneru podążają za określonym zachowaniem awaryjnym, zamiast być nieprawidłowymi.

Krok 7: Dodaj progresywne ulepszenie

Zachowaj domyślny układ stosu i warunkowo włącz bardziej zaawansowane zachowanie:

.content-card {
    display: grid;
    grid-template-columns: 1fr;
}

@supports (container-type: inline-size) {
    .card-container {
        container-type: inline-size;
    }

    @container (min-width: 480px) {
        .content-card {
            grid-template-columns: 180px minmax(0, 1fr);
        }
    }
}

Przeglądarki bez odpowiedniej funkcji zachowują funkcjonalny układ. Awaryjny nie musi pasować do każdej ulepszenia; musi pozostawać czytelny i użyteczny.

Zapytania kontenerowe nie zastępują Grid ani Flexbox

Grid i Flexbox układają elementy. Zapytania kontenerowe określają, kiedy określone reguły CSS powinny być stosowane.

Na przykład, responsywna kolekcja kart może potrzebować tylko Grid:

.product-grid {
    display: grid;
    grid-template-columns:
        repeat(auto-fit, minmax(min(100%, 240px), 1fr));
    gap: 1.5rem;
}

Dodaj zapytania kontenerowe, gdy projekt każdego wewnętrzny karty musi zmienić się w zależności od przypisanej szerokości. Unikaj wprowadzania kontenerów zapytań,_where standardowy Grid lub Flexbox już rozwiązał problem.

Co z zapytaniami stylu konteneru?

Zapytania kontenerowe mogą również testować pewne warunki stylu obliczone, w tym własności właściwości w obsługujących przeglądarkach:

.feature-panel {
    --panel-theme: dark;
}

@container style(--panel-theme: dark) {
    .feature-panel__title {
        color: white;
    }
}

To ilustruje składnię; zapytania stylu i nowsze capabilities zapytania mają różne szczegóły obsługi przeglądarki. Obsługa zapytań rozmiaru nie gwarantuje obsługi każdego zapytania stylu, właściwości czy nowszej funkcji stanu przewijania. Sprawdź dokładną funkcję w obecnych tabelach zgodności przed wdrożeniem produkcyjnym.

Pięć wspólnych błędów

1. Zapytywanie własnego rozmiaru elementu, aby stylować go samego

Technical workflow illustration

To nie działa tak, jak zamierzono:

.card {
    container-type: inline-size;
}

@container (min-width: 480px) {
    .card {
        display: grid;
    }
}

Zapytany kontener musi być przodkiem stylowanego elementu. Wprowadź zewnętrzny wrapper lub przenieś zawartość do odpowiedniego przodka.

2. Zapomnienie deklaracji konteneru

Zasada @container sama w sobie nie czyni automatycznie najbliższego rodzica kwalifikowanym kontenerem rozmiaru. Ogłoś container-type: inline-size lub użyj odpowiedniego skrótu.

3. Bezmyślnie ponowne używanie punktów przełamu widoku

Nie używaj automatycznie 768px lub 1024px tylko dlatego, że te liczby są znane. Wybierz punkt przełamu, tam gdzie zawartość komponentu rzeczywiście potrzebuje innego układu.

4. Stosowanie zawartości wszędzie

Zawartość zmienia zachowanie wymiarów. Zbyt wiele kontenerów może komplikować debugowanie, zwłaszcza gdy element polega na potomkach dla swoich wymiarów. Ustanawiaj kontenerzy celowo.

5. Zakładanie, że każda funkcja zapytania konteneru jest równie dobrze obsługiwana

Zapytania rozmiaru, zapytania stylu i nowsze capabilities mają różne historie zgodności. Sprawdź dokładnie składnię, którą planujesz wysłać.

Rozważania dotyczące wydajności

Zapytania kontenerowe działają w silniku CSS/layout przeglądarki. Mogą usunąć pewne obserwatory zmian rozmiaru oparte na JavaScript i ręczne pomiarów DOM.

To uproszczenie architektoniczne jest przydatne, ale zapytania kontenerowe nie gwarantują szybszej strony. Koszt renderowania zależy od stylesheet, złożoności DOM, struktury układu i wyborów zawartości.

Mierz wydajność i unikaj niepotrzebnych warstw zapytań.

Praktyczne zastosowania w WordPress i Joomla

Motywy blokowe WordPress: Ten sam blok może pojawić się w sekcji na pełną szerokość, wąskiej kolumnie lub sidebarze. Zapytania kontenerowe pozwalaj blokowi dostosować się bez osobnych wariantów desktop i mobilnych.

Szablony i moduły Joomla: Moduł może być przypisany do różnych pozycji szablonu. Układ oparty na komponentach może dostosować się do rzeczywistego szerokości modułu zamiast zgadywać z widoku.

Kreatorzy stron: Redaktenci często przenoszą komponenty między zagnieżdżonymi kolumnami. Reguły oparte na kontenerze mogą sprawić, że te komponenty będą bardziej odporne na zmiany układu.

Dashboardy: Paneli i widgety zmiennej wielkości mogą dostosować swoje wewnętrzne ukły, gdy zmienia się dostępna przestrzeń.

Kiedy jeszcze należy użyć zapytań mediowych?

Zapytania mediowe pozostają odpowiednie dla nawigacji zależnej od widoku, stylów drukowania, preferencji zmniejszonej ruchomości, zdolności wskaźnika i innych charakterystyk użytkownika/urządzenia.

Przydatna wytyczna to zapytania mediowe dla strony; zapytania kontenerowe dla komponentu. To nie jest absolutna zasada, ale to jasny sposób podziału odpowiedzialności.

Jak testować zapytania kontenerowe

Testuj ten sam komponent w szerokiej obszarze zawartości, wąskim sidebarze, siatce i modalu. Zmieniaj rozmiar konteneru, nie tylko okna przeglądarki.

Sprawdź pod_overflow poziomy, zniekształcenie obrazków, długie nagłówki, powiększenie przeglądarki, przetłumaczone zawartość i tryby pisania od prawej do lewej, gdzie jest to istotne.

Użyj narzędzi programistycznych przeglądarki, aby sprawdź obliczone właściwości konteneru i potwierdź, które reguły mają zastosowanie. Testuj na rzeczywistych wąskich urządzeniach oraz symulacjach desktopowych.

Wniosek

Zapytania kontenerowe CSS adresują długotrwałe ograniczenie responsywnego projektu opartego na widoku: dostępna przestrzeń komponentu nie musi odpowiadać szerokości przeglądarki.

Poprzez łączenie kontenerów rozmiaru z Grid, Flexbox i rozsądkowymi awaryjnymi, deweloperzy mogą tworzyć ponownie wykorzystywane komponenty, które naturalnie dostosowują się motywów, modułów, kreatorów stron i aplikacji.

Zacznij od funkcjonalnego domyślnego układu, deklaruj tylko znaczące kontenery, wybieraj punkty przełamu na podstawie zawartości i testuj w wielu kontekstach.

Projekt responsywny nie dotyczy już tylko wielkości ekranu. Dotyczy również przestrzeni dostępnej dla każdego komponentu.

Oficjalne referencje