CSS containment

{{CSSRef}} 

The CSS containment module defines containment and container queries.

Containment enables the isolation of page subtrees from the rest of the DOM. The browser can then improve performance by optimizing the rendering of these independent parts.

Container queries are similar to dimension media queries, except that the queries are based on the dimensions of a specific container element defined as a containment context, rather than on the dimensions of the viewport. Container queries enable querying a container’s size, properties, and property values to conditionally apply CSS styles. When applying these conditional styles, you can use container query length units, which specify lengths relative to the dimensions of the query container. Additional properties are defined to enable establishing a specific element as a query container and giving it a specific name.

Reference

Properties

• {{cssxref("contain")}} 
• {{cssxref("content-visibility")}} 

Events

• {{domxref("Element.contentvisibilityautostatechange_event", "contentvisibilityautostatechange")}} 

Interfaces

• {{domxref("ContentVisibilityAutoStateChangeEvent")}} 
  • {{domxref("ContentVisibilityAutoStateChangeEvent.skipped", "skipped")}}  property
• {{domxref("CSSContainerRule")}} 
  • {{domxref("CSSContainerRule.containerName")}} 
  • {{domxref("CSSContainerRule.containerQuery")}} 

Guides

• CSS container queries

  • : A guide to using container queries with @container, including naming containment contexts.

• Using CSS containment

  • : Describes the basic aims of CSS containment and how to leverage contain and content-visibility for a better user experience.

• Using container size and style queries

  • : A guide to writing container size and style queries with @container, including style queries for custom properties, query syntax and names, and nesting container queries.

Related concepts

• Layout and the containing block

• Block formatting context

• CSS conditional rules module

  • {{cssxref("@container")}}  at-rule
  • {{CSSxRef("container")}}  property
  • {{CSSxRef("container-name")}}  property
  • {{CSSxRef("container-type")}}  property

• CSS media queries module

  • {{cssxref("@media")}}  at-rule
  • CSS logical operators (not, or, and and)

• CSS transitions module

  • {{cssxref("@starting-style")}}  at-rule
  • {{cssxref("transition-behavior")}}  property

• CSS box sizing module

  • {{CSSxRef("aspect-ratio")}}  property
  • {{cssxref("contain-intrinsic-size")}}  shorthand property
  • {{CSSxRef("contain-intrinsic-inline-size")}}  property
  • {{CSSxRef("contain-intrinsic-size")}}  property
  • {{CSSxRef("contain-intrinsic-width")}}  property
  • {{CSSxRef("contain-intrinsic-height")}}  property

• CSS counter styles module

  • Using CSS counters guide

• CSS nesting module

  • CSS nesting at-rules guide

Specifications

{{Specifications}} 

See also

• Using feature queries
• Using CSS media queries
• Understanding aspect ratios
• {{cssxref("@supports")}}  at-rule