container

The container shorthand CSS property establishes the element as a query container and specifies the name or name for the containment context used in a container query.

Syntax

container: <container-name> / <container-type>;

Values

  • <container-name>: A case-sensitive name for the containment context. More details on the syntax are covered in the container-name property page.
  • <container-type>: The type of containment context. More details on the syntax are covered in the container-type property page.

Example

Given the following HTML example which is a card component with an image, a title, and some text:

<div class="container">
  <div class="card">
    <img src="image.png" alt="An awesome picture of a cat" />
    <h2>Card title</h2>
    <p>Card content</p>
  </div>
</div>

The explicit way to create a container context is to declare a container-type with an optional container-name:

.container {
  container-type: inline-size;
  container-name: sidebar;
}

The container shorthand is intended to make this simpler to define in a single declaration:

.container {
  container: sidebar / inline-size;
}

You can then target that container by name using the @container at-rule:

@container sidebar (min-width: 400px) {
  /* <stylesheet> */
}

For more information on container queries, see the CSS Container Queries page.

Specifications

Specification
CSS Containment Module Level 3
# container-shorthand

Browser compatibility

BCD tables only load in the browser

See also