Web & Udvikling

CSS Container Queries i 2026: Bygg responskomponenter uden videopunktesnit

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

Lær hvordan CSS containerqueries får responskomponenter til at tilpasse sig deres tilgægende plads i stedet for browsers vinduesstørrelse. Bygg genbrugelige kort, brug navngivne containere og containerenheder, og undgå almindelige layout- og kompatibilitetsproblemer.

CSS-containerqueries i 2026: Skab responsive komponenter uden viewport-breakpoints

Responsivt webdesign har traditionelt været baseret på mediequeries. Udviklere vælger viewport-breakpoints og tilpasser layouts til mobiltelefoner, tablets og computere. Det fungerer stadig godt for sideniveau-layouts, men moderne komponenter kan findes i mange forskellige sammenhænge, såsom fuld bredde sektioner, smalle sidebars, dashboards, modals og grids.

Et kort på en 1440-pixels bred desktop kan stadig kun have 280 pixels til rådighed inde i en sidebar. En viewport-breakpoint kan ikke pålideligt beskrive komponentens tilgængelige plads.

CSS-containerqueries lader komponenter reagere på størrelsen af en egnet slægtning, frem for kun viewport'en. Dette gør dem særligt nyttige i genbrugelige designsystemer, WordPress-blok-temaer, Joomla-moduler og sidebyggere.

Hvad er CSS-containerqueries?

En størrelseskontainerquery evaluerer dimensionerne af en udpeget slægtningcontainer. En komponent kan ændre sin interne layout, når den plads, der er tilgængelig for den, overskrider en grænse.

For eksempel kan et kort vise sit billede over sin tekst, når det er smalt, men flytte billedet ved siden af teksten, når dets container er mindst 480 pixels bred.

Mediequeries forbliver nyttige til sideomfattende navigation og enhedspreferencer. Containerqueries løser det separate problem med komponentniveau-responsivitet.

Mediequeries vs. containerqueries: visuel sammenligning og live-demo

Illustrationen sammenligner de to metoder. Flyt skyderen for at ændre kortets tilgængelige bredde. Demonstrationen bruger en ægte CSS-størrelseskontainerquery, ikke en JavaScript-kontrolleret layout-ændring.

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.

Breakpoint'et tilhører komponentens design snarere end en bestemt enhedskategori. På en smal telefonskærm begrænser demoen containeren til den tilgængelige viewport-bredde.

Trin 1: Opret et semantisk kort

Start med et kort, der kan vises i en artikelliste, produktanbefaling eller dokumentationsindeks:

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

Det ydre element bliver containeren til query'en. Det indre artikel-element er efterkommeren, hvis præsentation ændres.

Denne forskel er vigtig: en størrelseskontainerquery styler ikke det forespurgte element selv. Den evaluerer en slægtningcontainer og styler matchende efterkommere.

Trin 2: Skriv en robust standardlayout

Start med en layout, der forbliver brugbar uden containerqueries:

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

Den standard billede-over-tekst layout fungerer i smalle rum. minmax(0, 1fr) grid-track og min-width: 0 reducerer risikoen for, at langt indhold løber over.

Trin 3: Erklær containeren til query

Brug egenskaben container-type:

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

inline-size-værdien muliggør størrelsesqueries langs den inline-akse, som normalt svarer til bredde i horisontale skriveformer.

Du kan også støde på:

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

size-værdien understøtter begge akser, men indfører stærkere kontainerkrav. For de fleste responsive kort er inline-size et mere praktisk standardvalg.

Kontainering er vigtig, fordi browsere skal kunne beregne containerstørrelsen uden cirkulære afhængigheder af efterkommeres stilarter.

Trin 4: Tilføj den responsive regel

Nu ændrer du den interne layout kun, når containeren er bred nok:

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

En bred desktop-sidebar, der kun er 300 pixels bred, bevarer den stablede layout. Et kort i en 600-pixel-kolonne bliver horisontal, selv hvis viewport'en ikke er særlig bred.

Dette er den centrale fordel: komponenten reagerer på sin egen tilgængelige plads.

Trin 5: Brug navngivne containere til komplekse layouter

I et dashboard eller CMS-skabelon kan en komponent have flere nested containere. Som standard finder en størrelseskontainerquery den nærmeste egnet slægtning.

Navngiv den tilsigtede container, når du har brug for mere kontrol:

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

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

container-kompaktnotationen definerer både navnet og typen. Navngivning hjælper med at forhindre, at en urelateret nested container bliver target for query'en.

Trin 6: Brug containerrelaterede enheder

CSS inkluderer længdeenheder baseret på en egnet query-container:

Enhed Betydning
cqw 1% af containerbredde
cqh 1% af containerhøjde
cqi 1% af containerens inline-størrelse
cqb 1% af containerens blokstørrelse
cqmin Den mindre af cqi og cqb
cqmax Den større af cqi og cqb

Til flydende komponenttypografi:

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

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

I modsætning til vw kan cqi skalere tekst med komponentens container. Test altid læsbarheden, browserzoom og lange oversatte overskrifter. Hvis der ikke findes en egnet container, følger containerrelaterede enheder en angivet fallbackadfærd i stedet for at blive ugyldige.

Trin 7: Tilføj progressiv forbedring

Behold den standard stablede layout og aktiver betinget den mere avancerede adfærd:

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

Browsere uden den relevante funktion bevarer en funktionel layout. Fallback'en behøver ikke at matche alle forbedringer; den skal forblive læsbar og brugbar.

Containerqueries erstatter ikke Grid eller Flexbox

Grid og Flexbox arrangerer elementer. Containerqueries bestemmer, hvornår bestemte CSS-regler skal anvendes.

For eksempel kan en responsiv samling af kort kun har brug for Grid:

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

Tilføj containerqueries, når hver kort's interne design skal ændres i henhold til dens tildelte bredde. Undgå at introducere query-containere, hvor standard Grid eller Flexbox allerede løser problemet.

Hvad med container-style queries?

Containerqueries kan også teste nogle beregnede style-betingelser, inklusive tilpassede egenskaber i understøttende browsere:

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

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

Dette illustrerer syntaksen; style-queries og nyere query-muligheder har forskellige browser-support-detaljer. Support for størrelseskontainerqueries garanterer ikke support for hver style-query, egenskab eller nyere scroll-state-funktion. Verificer den præcise funktion mod aktuelle kompatibilitetstabeller før produktiondeployment.

Fem almindelige fejltagelser

1. Forespørge et elements egen størrelse for at style det selv

Technical workflow illustration

Dette fungerer ikke som tiltænkt:

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

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

Den forespurgte container skal være en slægtning til det stylede element. Introducer en ydre wrapper eller flyt kontainering til en egnet slægtning.

2. Glemme at erklære en container

En @container regel alene gør ikke automatisk den nærmeste forælder til en egnet størrelseskontainer. Erklær container-type: inline-size eller brug den tilsvarende kompaktnotation.

3. Genbruge viewport-breakpoints blindt

Brug ikke automatisk 768px eller 1024px, bare fordi de tal er bekendte. Vælg et breakpoint, hvor komponentens indhold faktisk har brug for en anden arrangement.

4. Anvende kontainering overalt

Kontainering ændrer størrelsesadfærd. For mange containere kan komplicere debugging, især når et element er afhængigt af efterkommere for dets dimensioner. Opret containere med vilje.

5. Antage, at hver containerquery-funktion er lige støttet

Størrelseskontainerqueries, style-queries og nyere funktioner har forskellige kompatibilitets-geschichter. Tjek den præcise syntaks, du planlægger at levere.

Ydeevneovervejelser

Containerqueries kører i browserens CSS/layout-engine. De kan eliminere nogle JavaScript-baserede resize observers og manuelle DOM-målinger.

Denne arkitekturforenkling er nyttig, men containerqueries garanterer ikke et hurtigere website. Gengivelsesomkostninger afhænger af stylesheet, DOM-kompleksitet, layout-struktur og kontainervalg.

Mål ydeevne og undgå unødvendige query-lag.

Praktiske anvendelser i WordPress og Joomla

WordPress blok-temaer: Det samme blok kan vises i en fuld bredde sektion, en smal kolonne eller en sidebar. Containerqueries lader blokken tilpasse sig uden separate desktop- og mobilvarianter.

Joomla skabeloner og moduler: En modul kan tildeles til forskellige skabelonpositioner. En komponentbaseret layout kan tilpasse sig den faktiske modulbredde i stedet for at gætte fra viewport'en.

Sidebyggere: Redaktører flytter ofte komponenter mellem nested kolonner. Containerbaserede regler kan gøre disse komponenter mere modstandsdygtige over for layoutændringer.

Dashboards: Sammenlignelige paneler og widgets kan tilpasse deres interne layout, når tilgængelig plads ændres.

Hvornår bør du stadig bruge mediequeries?

Mediequeries forbliver passende til viewport-afhængig navigation, print-stilarter, reduceret-bevægelse-præferencer, pointer-muligheder og andre bruger/enheds-egenskaber.

En nyttig retningslinje er mediequeries for siden; containerqueries for komponenten. Det er ikke en absolut regel, men det er en klar måde at dele ansvar på.

Hvordan kan man teste containerqueries

Test den samme komponent i et bredt indholdsområde, smal sidebar, grid og modal. Resizer containeren, ikke kun browser-vinduet.

Kontroller for horisontal overløb, billedeforvrængning, lange titler, browserzoom, oversat indhold og højre-til-venstre skriveformer, hvor relevant.

Brug browserens udviklerværktøjer til at inspicere beregnede container-egenskaber og bekræfte, hvilke regler der gælder. Test på faktisk smalle enheder samt desktop-simuleringer.

Konklusion

CSS-containerqueries adresserer en langvarig begrænsning af viewport-baseret responsiv design: en komponents tilgængelige plads matcher ikke nødvendigvis browserens bredde.

Ved at kombinere størrelseskontainere med Grid, Flexbox og fornuftige fallbacks kan udviklere skabe genbrugelige komponenter, der tilpasser sig naturligt på tværs af temaer, moduler, sidebyggere og applikationer.

Start med en funktionel standardlayout, erklær kun meningsfulde containere, vælg breakpoints baseret på indhold og test i flere kontekster.

Responsiv design handler ikke længere kun om skærmstørrelsen. Det handler også om den plads, der er tilgængelig for hver komponent.

Officielle referencer