大网数据广告活动
Web 标准与前端开发

`container-name` CSS property

· 52CE 我爱测

The **container-name** CSS property specifies a list of query container names used by the @container at-rule in a container query.

The container-name CSS property specifies a list of query container names used by the @container at-rule in a container query.

Syntax

container-name: none;

/* A single name */
container-name: my-layout;

/* Multiple names */
container-name: my-page-layout my-component-library;

/* Global Values */
container-name: inherit;
container-name: initial;
container-name: revert;
container-name: revert-layer;
container-name: unset;

Values

This property is specified as a space-separated list of <custom-ident> values or the keyword none:

  • none

    • : The default value. The query container has no name.
  • custom-ident

    • : A case-sensitive string that is used to identify the container. The following conditions apply:
      • The name must not equal or, and, not, or default.
      • The name value must not be in quotes.
      • The dashed ident intended to denote author-defined identifiers (e.g., --container-name) is permitted.
      • A list of multiple names separated by a space is allowed.

Description

With no name specified, a container query will apply styles to elements based on attributes such as the size or scroll-state of the nearest ancestor with a containment context.

[!NOTE] Size containers' descendants can be sized using container query length units.

When a containment context is given a name, it can be specifically targeted by setting that name on a @container at-rule.

It is possible to create a query container by assigning a container-name to an element, and then query only the existence of that name in the associated @container at-rule, with no query expression specified. These so-called name-only container queries enable selectively applying styles to elements based only on whether they have an ancestor with a specific container-name set.

Formal definition

Formal syntax

Examples

Using a container name

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

<div class="card">
  <div class="post-meta">
    <h2>Card title</h2>
    <p>My post details.</p>
  </div>
  <div class="post-excerpt">
    <p>
      A preview of my <a href="https://example.com">blog post</a> about cats.
    </p>
  </div>
</div>

To create a containment context, add the container-type property to an element in CSS. The following example creates two containment contexts, one for the card meta information and one for the post excerpt:

[!NOTE] A shorthand syntax for these declarations are described in the container page.

.post-meta {
  container-type: inline-size;
}

.post-excerpt {
  container-type: inline-size;
  container-name: excerpt;
}

Writing a container query via the @container at-rule will apply styles to the elements of the container when the query evaluates to true. The following example has two container queries, one that will apply only to the contents of the .post-excerpt element and one that will apply to both the .post-meta and .post-excerpt contents:

@container excerpt (width >= 400px) {
  p {
    visibility: hidden;
  }
}

@container (width >= 400px) {
  p {
    font-size: 2rem;
  }
}

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

Using multiple container names

You can also provide multiple names to a container context separated by a space:

.post-meta {
  container-type: inline-size;
  container-name: meta card;
}

This will allow you to target the container using either name in the @container at-rule. This is useful if you want to target the same container with multiple container queries where either condition could be true:

@container meta (width <= 500px) {
  p {
    visibility: hidden;
  }
}

@container card (width <= 200px) {
  h2 {
    font-size: 1.5em;
  }
}

Using a name-only container query

This example demonstrates how to use a name-only container query.

HTML

We include a div with an id of container, and three p elements, two inside the container, and one outside the container:

<div id="container">
  <p>I'm in the container.</p>
  <p>I'm also in the container.</p>
</div>
<p>I'm not in the container.</p>

CSS

We assign a name to the container:

#container {
  container-name: my-container;
}

We can then selectively apply styles only to elements inside containers with that name set, as shown in the next snippet.

@container my-container {
  p {
    background-color: lime;
    font-size: 1.3rem;
    width: 50vw;
    padding: 0.5rem;
    font-family: sans-serif;
  }
}

Result

using_a_name-only_container_query

The specified styles should be applied only to the first and second p elements, but not to the third.

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。