Webb & utveckling

CSS Container Queries 2026: Bygg responsiva komponenter utan viewport-brytpunkter

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

Lär dig hur CSS container queries gör att responsiva komponenter anpassar sig efter deras tillgängliga utrymme istället för webbläsarens viewport. Bygg återanvändbara kort, använd namngivna containrar och container-enheter, och undvik vanliga layout- och kompatibilitetsproblem.

Responsiv webbdesign har traditionellt förlitat sig på mediafrågor. Utvecklare väljer viewport-brytpunkter och justerar layouter för telefoner, surfplattor och datorer. Det fungerar fortfarande bra för sidnivålayouter, men moderna komponenter dyker ofta upp i många sammanhang: fullbreddssektioner, smala sidofält, instrumentpaneler, modaler och rutnät.

Ett kort på en 1 440 pixlar bred stationär dator kan ändå bara ha 280 pixlar tillgängliga inuti ett sidofält. En viewport-brytpunkt kan inte pålitligt beskriva den komponentens tillgängliga yta.

CSS-containerfrågor låter komponenter svara på storleken hos en behörig förälder snarare än bara viewporten. Det gör dem särskilt användbara i återanvändbara designsystem, WordPress blockteman, Joomla-moduler och sidbyggare.

Vad är CSS-containerfrågor?

En storlekscontainerfråga utvärderar måtten på en utpekad föräldercontainer. En komponent kan ändra sin interna layout när det tillgängliga utrymmet överskrider ett tröskelvärde.

Till exempel kan ett kort visa sin bild ovanför sin text när det är smalt, men flytta bilden bredvid texten när dess container är minst 480 pixlar bred.

Mediafrågor är fortfarande användbara för sidövergripande navigation och enhetspreferenser. Containerfrågor löser det separata problemet med komponentnivåresponsivitet.

Mediafrågor mot containerfrågor: visuell jämförelse och live-demo

Illustrationen jämför de två metoderna. Flytta reglaget för att ändra kortets tillgängliga bredd. Demonstrationen använder en riktig CSS-storlekscontainerfråga, inte en JavaScript-kontrollerad layoutväxling.

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.

Brytpunkten tillhör komponentens design snarare än en viss enhetskategori. På en smal telefonkärm begränsar demot containern till den tillgängliga viewportbredden.

Steg 1: Bygg ett semantiskt kort

Börja med ett kort som kan förekomma i en artikellista, produktrekommendation eller dokumentationsindex:

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

Ytterelementet kommer att bli frågecontainern. Den inre artikeln är det efterkommande element vars presentation ändras.

Denna skillnad är viktig: en storlekscontainerfråga stylar inte det frågade elementet självt. Den utvärderar en föräldercontainer och stylar matchande efterkommande element.

Steg 2: Skriv en robust standardlayout

Börja med en layout som fortfarande är användbar utan containerfrågor:

.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;
}

Standardlayouten med bild ovanför text fungerar på trånga ytor. minmax(0, 1fr) rutnätsspår och min-width: 0 minskar risken för att långt innehåll svämmar över.

Steg 3: Deklarera frågecontainern

Använd egenskapen container-type:

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

Värdet inline-size aktiverar storleksfrågor längs inline-axeln, vilket vanligtvis motsvarar bredd i horisontella skrivlägen.

Du kan också stöta på:

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

Värdet size stöder båda axlarna men inför striktaare innehållningskrav. För de flesta responsiva kort är inline-size ett mer praktiskt standardval.

Innehållning är viktig eftersom webbläsare måste kunna beräkna containerstorlek utan cirkulära beroenden till efterkommandes stilar.

Steg 4: Lägg till den responsiva regeln

Ändra nu den interna layouten endast när föräldercontainern är tillräckligt bred:

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%;
    }
}

Ett brett stationärt sidofält som bara är 300 pixlar brett behåller den staplade layouten. Ett kort i en 600 pixlars innehållskolumn blir horisontellt, även om viewporten inte är särskilt bred.

Detta är den centrala fördelen: komponenten svarar på sitt eget tillgängliga utrymme.

Steg 5: Använd namngivna containrar för komplexa layouter

I en instrumentpanel eller CMS-mall kan en komponent ha flera nästlade containrar. Som standard hittar en storleksfråga den närmaste behöriga föräldern.

Namngiv den avsedda containern när du behöver mer kontroll:

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

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

Förkortningen container definierar både namn och typ. Namngivning hjälper till att förhindra att en orelaterad nästlad container blir frågemålet.

Steg 6: Använd containerrelativa enheter

CSS innehåller längdenheter baserade på en behörig frågecontainer:

Enhet Betydelse
cqw 1 % av containerbredd
cqh 1 % av containerhöjd
cqi 1 % av containerstorlek i inline-riktning
cqb 1 % av containerstorlek i block-riktning
cqmin Mindre av cqi och cqb
cqmax Större av cqi och cqb

För flytande komponenttypografi:

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

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

Till skillnad från vw kan cqi skala text tillsammans med komponentens container. Testa alltid läsbarhet, webbläsarzoom och långa översatta rubriker. Om ingen behörig container finns följer containerrelativa enheter angivet fallback-beteende istället för att bli ogiltiga.

Steg 7: Lägg till progressiv förbättring

Behåll standardlayouten med staplad layout och villkorsstyr den mer avancerade beteendet:

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

Webbläsare utan den aktuella funktionen behåller en fungerande layout. Fallbacken behöver inte matcha varje förbättring; den behöver förbli läsbar och användbar.

Containerfrågor ersätter inte Grid eller Flexbox

Grid och Flexbox ordnar element. Containerfrågor avgör när vissa CSS-regler ska tillämpas.

Till exempel kan en responsiv samling kort bara behöva Grid:

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

Lägg till containerfrågor när varje kort interna design behöver ändras enligt dess tilldelade bredd. Undvik att införa frågecontainrar där standard Grid eller Flexbox redan löser problemet.

Vad är det med containerns stilfrågor?

Containerfrågor kan också testa vissa beräknade stilvillkor, inklusive anpassade egenskaper i stödjande webbläsare:

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

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

Detta illustrerar syntaxen; stilfrågor och nyare frågefunktioner har olika webbläsarstöd. Stöd för storleksfrågor garanterar inte stöd för varje stilfråga, egenskap eller nyare scrolltillståndsfunktion. Verifiera den exakta funktionen mot aktuella kompatibilitetstabeller innan produktionssättning.

Fem vanliga misstag

1. Fråga efter ett eget elements storlek för att styla det självt

Technical workflow illustration

Detta fungerar inte som avsett:

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

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

Det frågade containern måste vara en förfader till det stylade elementet. Introducera en yttre wrapper eller flytta innehållning till en lämplig förfader.

2. Glömma att deklarera en container

Enbart en @container-regel gör inte automatiskt närmaste förälder till en behörig storlekscontainer. Deklarera container-type: inline-size eller använd motsvarande förkortning.

3. Återanvända viewport-brytpunkter blint

Använd inte automatiskt 768px eller 1024px bara för att de siffrorna är kända. Välj en brytpunkt där komponentens innehåll faktiskt behöver en annan ordning.

4. Tillämpa innehållning överallt

Innehållning ändrar storleksbeteende. För många containrar kan komplicera felsökning, särskilt när ett element förlitar sig på efterkommande för sina mått. Upprätta containrar medvetet.

5. Anta att varje containerfrågefunktion har lika bra stöd

Storleksfrågor, stilfrågor och nyare funktioner har olika kompatibilitetshistorik. Kontrollera exakt syntax du planerar att leverera.

Prestandaöverväganden

Containerfrågor körs i webbläsarens CSS/layout-motor. De kan eliminera vissa JavaScript-baserade resize-observatörer och manuella DOM-mätningar.

Den arkitektoniska förenklingen är användbar, men containerfrågor garanterar inte en snabbare webbplats. Renderingskostnaden beror på stylesheet, DOM-komplexitet, layoutstruktur och innehållningsval.

Mät prestanda och undvik onödiga frågelager.

Praktiska tillämpningar i WordPress och Joomla

WordPress blockteman: Samma block kan förekomma i en fullbreddssektion, en smal kolumn eller ett sidofält. Containerfrågor låter blocket anpassa sig utan separata stationära och mobila varianter.

Joomla-mallar och moduler: En modul kan tilldelas olika mallpositioner. En komponentbaserad layout kan anpassa sig till modulens faktiska bredd istället för att gissa utifrån viewporten.

Sidbyggare: Redaktörer flyttar ofta komponenter mellan nästlade kolumner. Containerbaserade regler kan göra dessa komponenter mer motståndskraftiga mot layoutförändringar.

Instrumentpaneler: Storleksändrbara paneler och widgets kan justera sina interna layouter när tillgängligt utrymme ändras.

När ska du fortfarande använda mediafrågor?

Mediafrågor är fortfarande lämpliga för viewportberoende navigation, utskriftsstilar, preferenser för minskad rörelse, pekarkapacitet och andra användar/enhetskaraktärer.

En användbar riktlinje är mediafrågor för sidan; containerfrågor för komponenten. Det är ingen absolut regel, men ett tydligt sätt att dela upp ansvar.

Så testar du containerfrågor

Testa samma komponent i ett brett innehållsområde, smalt sidofält, rutnät och modal. Ändra storlek på containern, inte bara webbläsarfönstret.

Kontrollera horisontellt overflow, bildförvrängning, långa titlar, webbläsarzoom, översatt innehåll och skrivlägen från höger till vänster där det är relevant.

Använd webbläsarens utvecklarverktyg för att inspektera beräknade containeregenskaper och bekräfta vilka regler som tillämpas. Testa på verkliga trånga enheter såväl som stationära simulationer.

Slutsats

CSS-containerfrågor åtgärdar en långvarig begränsning av viewportbaserad responsiv design: en komponent tillgängliga utrymme matchar inte nödvändigtvis webbläsarens bredd.

Genom att kombinera storlekscontainrar med Grid, Flexbox och rimliga fallbacks kan utvecklare skapa återanvändbara komponenter som anpassar sig naturligt över teman, moduler, sidbyggare och applikationer.

Börja med en fungerande standardlayout, deklarera endast meningsfulla containrar, välj brytpunkter baserat på innehåll och testa i flera sammanhang.

Responsiv design handlar inte längre bara om skärmens storlek. Det handlar också om det utrymme som är tillgängligt för varje komponent.

Officiella referenser