Container Queries — Complete Guide
Container Queries — Complete Guide: free step-by-step lesson with examples, common mistakes, and interview tips — part of CSS Tutorial on Toolliyo Academy.
On this page
CSS Tutorial · Lesson 27 of 100
Container Queries
Foundations & Layout ✓ → Responsive & Motion → Architecture & Perf → Projects
Responsive & Motion · 2 — Adapt · ~13 min read · CSS — Responsive Design
1. Introduction
Today: Container Queries. Read the diagram, paste the CSS, then change one value and watch the UI update.
Container queries apply styles based on parent container size, not viewport. @container (min-width: 400px) styles children when wrapper is wide enough.
2. Real-world story
Same product card in narrow sidebar and wide grid adapts independently.
Outcome: Container queries end duplicate card CSS variants.
3. Why it matters
StyleVerse reusable card components live in sidebars and main areas — container queries adapt per slot, not global breakpoint.
4. Visual understanding
Read this diagram — the mental model for Container Queries.
parent { display: flex; gap: … }
children share a row/column and grow with flex
5. Key concepts (easy words)
| Idea | Meaning |
|---|---|
| What | Container queries apply styles based on parent container size, not viewport. @container (min-width: 400px) styles children when wrapper is wide enough. |
| Remember | container-type on ancestor enables @container. Components respond to their slot width. Complements viewport media queries. |
| Responsive tip | Start mobile-first; enhance with min-width queries. |
6. How it works
- card-host defines query container. product-card stacks vertically by default; horizontal layout when container exceeds 360px inline size.
- container-type on ancestor enables @container.
- Components respond to their slot width.
- Check the result in DevTools → Computed and the box model overlay.
7. Choose wisely
| Option | Notes |
|---|---|
| Do | Practice Container Queries on a small StyleVerse card |
| Avoid | Copying huge frameworks before learning core CSS |
8. Try this example
Paste into a <style> block (or use Run Example). Refresh to see StyleVerse UI changes.
.card-host { container-type: inline-size; container-name: card; }
.product-card {
display: flex;
flex-direction: column;
gap: 8px;
}
@container card (min-width: 360px) {
.product-card { flex-direction: row; align-items: center; }
}Line walkthrough
| Code | What it means |
|---|---|
.card-host { container-type: inline-size; container-name: card; } | Selector — picks which elements get these declarations. |
.product-card { | Selector — picks which elements get these declarations. |
display: flex; | Declaration — property and value that change appearance. |
flex-direction: column; | Declaration — property and value that change appearance. |
gap: 8px; | Declaration — property and value that change appearance. |
} | Ends the rule block. |
@container card (min-width: 360px) { | Selector — picks which elements get these declarations. |
.product-card { flex-direction: row; align-items: center; } | Selector — picks which elements get these declarations. |
} | Ends the rule block. |
Run Example »
Edit the code below and click Run to see the result in Toolliyo’s live editor.
9. Another real-world angle
10. Best practices checklist
- Prefer classes over ids for reusable StyleVerse components.
- Use design tokens (CSS variables) for color and spacing.
- Mobile-first media queries; test keyboard focus.
- Keep specificity low — avoid !important except rare overrides.
- Animate transform/opacity when you can; respect prefers-reduced-motion.
11. Common mistakes
- Forgetting container-type on parent — queries never fire.
- Replacing all media queries — viewport breakpoints still needed for page shell.
12. Practice in the browser
- Wrap product-card in div.card-host.
- Resize parent column not whole page.
- Watch layout flip at 360px container width.
- Use container-type: size for both axes when needed.
Experiments
- Add @container (min-width: 500px) showing extra metadata row.
- Name multiple containers for nested query targets.
13. FAQ
Where should I put CSS for Container Queries?
Start in a <style> block or styles.css linked from HTML. Later use CSS Modules, Tailwind, or tokens in a design system.
Why is my rule not applying?
Check selector match, typos, specificity, and whether a more specific rule or inline style wins. DevTools Computed tells the truth.
Flexbox or Grid for this?
Flex for one direction (toolbars, card rows). Grid for two-dimensional page frames. Many UIs use both.
14. Interview questions
Explain Container Queries simply.
Container queries apply styles based on parent container size, not viewport. @container (min-width: 400px) styles children when wrapper is wide enough.
How do you debug CSS?
Inspect element, toggle declarations, read Computed styles, outline the box model, and reduce specificity conflicts.
How does this show up in production UI?
Container queries end duplicate card CSS variants.
15. Remember
- container-type on ancestor enables @container.
- Components respond to their slot width.
- Complements viewport media queries.
Interview prep for this lesson
Practice these questions aloud after reading—each links to a full structured answer.
Sign in to ask a question or upvote helpful answers.
No questions yet — be the first to ask!
