Skip to main content
Dublin Library

The Publishing Project

Building a Card Component


Container queries introduce an additional and complementary way to create content in addition to what media queries allow.

This post will look at container queries and how to use them to build a reusable card component.

What are container queries and how do they work #

With container queries, you can apply styles to an element based on the size of the element's container rather than the viewport (like we can with media queries). For example, if a container has less space available in the surrounding context, you can hide certain elements or use smaller fonts.

Using container queries #

Using container queries is a two-step process:

  1. Tell the browser what type of container we want to create
  2. Use the @container at-rule with an optional name and a media query-like dimension check to create one or more container queries

Now, let's look at how this works.

Using the following HTML content

<div class="layout-item">
  <div class="card">
    <h2>Card Title</h2>
    <div class="card-content">
				alt="placeholder for image"

      <p>Card Content</p>


    <div class="card-footer">
        <li><a href="#">Home</a></li>


We can create the container query like this:

We convert the outermost container (.layout-item) into an inline-size container.

.layout-item {
  container: card / inline-size;

/* initial styles for the component children */

Then we can create one or more container queries and change the styles for the card components.

In this example, we use the newer query syntax to create a container for cards that are equal to or less than 800 pixels wide.

/* Container query */
@container card (width <= 800px) {
		Styles for elements that change when
		the width is 800px or larger

The full example is in this CodePen:

Depending on your need you may create additional container queries. For example, you could create specific styles when the container is between two specific values.

@container card (200px <= width <= 400px) {
		styles when width matches the query

You can also nest container queries as shown in this Pen by Michelle Barker. The Pen shows how to use container size queries with Grid and how to make them work together to create more complex layouts.

Edit on Github