CSS 系列：很有用的新属性 display: contents💭 WHAT display: contents，这是

看了很多文章，大家都没讲到重点，且最近浏览器也对 display: contents 做了更新或 bugfix，本文站在 2025 年总结下。

💭 WHAT

display: contents，这是 CSS 中一个很有用的属性值。它可以让一个元素在布局中“消失”，但它的子元素仍然会保留在文档流中，就好像这个元素从未存在过一样。这意味着，原本由这个元素生成的框 （包括背景、边框、内边距等）都不会被渲染，但它的子元素仍然会继承它的颜色、字体等属性，并且可以参与到上一层级的布局中。这在需要保持 HTML 语义结构的同时或无法修改 HTML 布局时，又想让某些元素在视觉上或布局上消失时非常有用。

❓ WHY

display: contents 是一个用于创建布局的了不起的功能。它允许你将 flex 项或 grid 项的子元素视为它们自己就是 flex(grid) 项。换句话说，你可以将嵌套的 DOM 树“展平”，以便在一个 flex 或 grid 系统内使用它。如果你无法更改当前布局的 DOM 结构，或者出于任何原因不想更改它，但仍然希望使用 flex(grid) 能力来移动和重新定位元素——不仅适用于 flex(grid) 布局内的兄弟元素，还包括它们的子元素和孙子元素。

—— stackoverflow.com/questions/7…

解释上面这段话：“消失”描述成“flatten”可能更形象，其目的是让内部元素参与外部布局，参与外部布局有什么用？在 flex / grid 布局中，只有直接子元素才会被认为是 flex / grid item，才能被其影响。这就是 display: contents 用武之地。

展平：

<div class="parent"> // display: contents
  <p>子元素</p>
  <p>子元素</p>
</div>

parent 应用 display: contents 后浏览器将视其为

<p>子元素</p>
<p>子元素</p>

是不是就像数组的展平操作（[1, [2, 3]].flat(1) => [1, 2, 3]），将 [div, [p, p]] 去除嵌套展平成 [p, p]！

📀 使用场景

让非直接子元素参与 flex / grid 布局

<section style="display: flex">
   <div>A</div>
   <div> // <- `display: contents`  让 div 从 UI 上隐藏，让其子元素参与其爷爷 section 的 flex 布局
     <span class="b1">B1</span>
     <span class="b2">B2</span>
    </div>
    <div>C</div>
</section>

详见 stackoverflow.com/questions/7… 第二个回答即可。

无法修改 HTML 布局，比如 Antd 组件

比如想“一键”去除 padding 或 margin border 等 box 属性，可以使用 display: contents，非常方便。

block 变 inline

比如有个组件被 div 包裹，里面是 span 等内联元素，不修改布局的情况下，可以给 div 增加 display: contents，则内部元素“露出”自然就变成了 inline 布局。

👩‍🦽 会有无障碍问题吗

经试验 Chrome 最新版本没有该问题，如果有问题是浏览器实现没有遵循 CSS 规范。故应该放心使用。

https://developer.mozilla.org/en-US/docs/Web/CSS/display#contents

CSS 系列：很有用的新属性 display: contents