displayBaseline Widely available *This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
* Some parts of this feature may have varying levels of support.
Learn moreSee full compatibilityReport feedbackCSS display 属性设置元素是否被视为块级或行级盒子以及用于子元素的布局,例如流式布局、网格布局或弹性布局。
形式上,display 属性设置元素的内部和外部的显示类型。外部类型设置元素参与流式布局;内部类型设置子元素的布局。一些 display 值在它们自己的单独规范中完整定义;例如,在 CSS 弹性盒模型的规范中,定义了声明 display: flex 时会发生的细节。
尝试一下
display: block;
display: inline-block;
display: none;
display: flex;
display: grid;
Apply different display
values on the dashed orange-bordered
div
, which contains three child elements.
Some text A.
Some text B.
.example-container {
width: 100%;
height: 100%;
}
code {
background: #8888;
}
#example-element {
border: 3px dashed orange;
}
.child {
display: inline-block;
padding: 0.5em 1em;
background-color: #ccccff;
border: 1px solid #ababab;
color: black;
}
语法CSS display 规定使用的关键字。
css/* 预组合值 */
display: block;
display: inline;
display: inline-block;
display: flex;
display: inline-flex;
display: grid;
display: inline-grid;
display: flow-root;
/* 生成盒子 */
display: none;
display: contents;
/* 多关键字语法 */
display: block flex;
display: block flow;
display: block flow-root;
display: block grid;
display: inline flex;
display: inline flow;
display: inline flow-root;
display: inline grid;
/* 其他值 */
display: table;
display: table-row; /* 所有的 table 元素 都有等效的 CSS display 值 */
display: list-item;
/* 全局值 */
display: inherit;
display: initial;
display: revert;
display: revert-layer;
display: unset;
分组的值关键值可以被分组为六个种类。
外部表现
这些关键字规定元素的外部显示类型,实际上就是其在流式布局中的角色:
block
该元素生成一个块级盒子,在正常的流中,该元素之前和之后产生换行。
inline
该元素生成一个或多个行级盒子,它们之前或者之后并不会产生换行。在正常的流中,如果有空间,下一个元素将会在同一行上。
备注:
在支持多关键字语法的浏览器中,当 display 属性仅有一个外部值(例如 display: block 或 display: inline)时,内部值会被设置为 flow(例如 display: block flow 和 display: inline flow)。
备注:
为了保证布局在旧浏览器生效,你可以使用单值语法,例如,对于 display: inline flex,可以设置以下回退
css.container {
display: inline-flex;
display: inline flex;
}
参见 CSS display 使用多值语法,以获得更多信息。
内部表现
这些关键字规定了元素的内部显示类型,其定义了该内容布局时的格式上下文的类型(假设它是一个非替换元素):
flow
该元素使用流式布局(块向和行向布局)来排布它的内容。
如果它的外部显示类型是 inline 或 run-in,并且它参与一个区块或者行级格式上下文,那么它将生成一个行级盒子。否则它将生成一个块容器盒。
根据其他属性的值(例如 position、float 或 overflow)以及它自身是否参与到区块或者行级格式化上下文,它要么为它的内容建立新的区块格式化上下文(BFC),要么将其内容集成到其父元素的格式化上下文中。
flow-root
该元素生成一个块级元素盒,其会建立一个新的区块格式化上下文,定义格式化上下文的根元素。
table
该元素的行为类似于 HTML 中的
元素。它定义了一个块级别的盒子。
flex
该元素的行为类似块级元素并且根据弹性盒模型布局它的内容。
grid
该元素的行为类似块级元素并且根据网格模型布局它的内容。
ruby
该元素的行为类似行级元素并且根据 ruby 格式化模型布局它的内容。它的行为像关联的 HTML 的 元素。
备注:
在支持多关键字语法的浏览器中,当 display 属性仅有一个内部值(例如 display: flex 或 display: grid)时,外部值会被设置为 block(例如 display: block flex 和 display: block grid)。
列表元素
该元素为内容生成一个块级盒子和一个单独的列表元素行级盒子。
list-item 的单独值将导致元素的行为类似于一个列表元素。其可以与 list-style-type 和 list-style-position 一起使用。
list-item 也可以与任意的 关键字和 中的 flow 或 flow-root 关键字组合。
备注:
在支持多关键字语法的浏览器中,如果没有指定内部值,其值默认为 flow。如果没有指定外部值,主体盒子将具有 block 的外部显示类型。
内部
一些布局模型,例如 table 和 ruby 有一个复杂的内置结构,它们的子孙后代可以扮演几个不同的角色。本节定义的这些“内部”display 值,仅在特定的布局模式下有用。
table-row-group
该元素的行为类似于 HTML 的
元素。
table-header-group
该元素的行为类似于 HTML 的 元素。
table-footer-group
该元素的行为类似于 HTML 的
元素。
table-row
该元素的行为类似于 HTML 的
元素。
table-cell
该元素的行为类似于 HTML 的
元素。
table-column-group
该元素的行为类似于 HTML 的
元素。
table-column
该元素的行为类似于 HTML
元素。
table-caption
该元素的行为类似于 HTML 的
元素。
ruby-base
该元素的行为类似于 HTML 的 元素。
ruby-text
该元素的行为类似于 HTML 的 元素。
ruby-base-container
该元素是作为匿名盒子生成的。
ruby-text-container
该元素的行为类似于 HTML 的 元素。
盒
这些关键词定义一个元素到底是否产生 display 盒。
contents
这些元素自身不会产生特定的盒子。它们被伪盒子(pseudo-box)和子盒子取代。请注意,CSS Display Level 3 规范中定义了 contents 值如何影响“异常元素”——这些元素不是纯粹由 CSS 盒模型概念呈现的(例如替换元素)。更多的细节请参见附录 B:display 的影响:异常元素的内容。
none
使元素不再显示,其对布局不会有影响(文档渲染得好像这个元素并不存在)。所有的后代元素也不会再显示。为了使元素占据一个它通常占据的空间,但实际上没有渲染任何东西,应该使用 visibility 属性。
预组合
CSS 2 为 display 属性使用单关键字的预组合的语法,对相同布局模式的块级和行级变体需要单独的关键字。
inline-block
该元素生成块级元素盒,如果它是一个单独的行级盒,它将和周围的内容一起流动(行为类似于替换元素)。
它等同于 inline flow-root。
inline-table
inline-table 值在 HTML 中没有直接的映射。它行为类似于 HTML 的
元素,但实际是一个行级盒,而不是一个块级盒子。table 盒内部是一个块级上下文。
它等同于 inline table。
inline-flex
元素的行为类似于行级元素并且它的内容根据弹性盒模型布局。
它等同于 inline flex。
inline-grid
元素的行为类似于行级元素并且它的内容根据网格盒模型布局。
它等同于 inline grid。
你现在应该使用什么语法?CSS display 模块描述了多关键字语法,你可以使用 display 属性明确地定义外部和内部 display 值。支持单个关键字值(预组合 值)以实现向后兼容性。
例如,你可以按以下方式使用两个值指定一个行级的弹性容器:
css.container {
display: inline flex;
}
也可以使用传统的单值来指定。
css.container {
display: inline-flex;
}
有关规范中的这些更改的更多信息,请参考指南 CSS display 使用多值语法。
全局值css/* 全局值 */
display: inherit;
display: initial;
display: unset;
描述display 为不同类型的值设置了单独的页面,其中包含这些值的多个示例——请参阅语法部分。此外,请参阅以下资料,其中深度展示了 display 的各种值。
多关键字值
CSS display 使用多值语法。
CSS 流式布局(display: block、display: inline)
常规流中的块向和行向布局
流布局和溢出
流布局和书写模式
格式化上下文简介
应用或脱离流式布局
display: flex
弹性盒基础概念
对齐弹性容器中的弹性项目
控制弹性元素在主轴上的比例
掌握弹性物件的包装
弹性元素排序
弹性盒子与其他布局方法的联系
弹性盒的典型用例
display: grid
网格布局的基本概念
网格布局和其他布局方法的联系
基于线的定位
网格模板区域
使用命名线布局
网格布局中的自动定位
网格布局中的盒模型对齐
网格、逻辑值和书写模式
CSS 网格布局和无障碍
利用网格布局实现常用布局
display 动画支持的浏览器使用离散的动画类型设置 display 动画。这通常意味着,属性的值将在动画播放到 50% 时在两个值之间切换。
有一个例外,那就是将 display: none 设置为动画的开始或结束。这种情况下,浏览器会在这两个值之间切换,以便于在整个动画持续时间内显示动画内容。例如:
当将 display 动画设置为从 none 到 block(或另一个可见的 display 值)时,该值将在动画持续时间的 0% 处切换到 block,从而使其始终可见。
当将 display 动画设置为从 block(或另一个可见的 display 值)到 none时,该值将在动画持续时间的 100% 处切换到 none,从而使其始终可见。
此行为对于创建入场/出场动画非常有用,例如,你想要使用 display: none 从 DOM 中删除一个容器,但又同时使用 opacity 将其淡出(而不是立即消失)。
在使用 CSS 动画为 display 设置动画时,需要在明确的关键帧(例如使用 0% 或 from)中提供开始的 display 值。有关示例,请参见使用 CSS 动画。
在使用 CSS 过渡为 display 设置动画时,需要两个额外的附加条件:
@starting-style 提供了要从第一次显示动画元素时开始过渡的属性的起始值。这是避免意外行为所必需的。默认情况下,CSS 过渡不会在元素的第一次样式更新时触发,也不会在 display 类型从 none 更改为另一种类型时触发。
transition-behavior: allow-discrete 需要在 transition-property 声明上设置,已启用 display 过渡。
有关 display 属性过渡的更多示例,请参见 @starting-style 和 transition-behavior。
无障碍考虑display: none在一个元素中使用 display 的值为 none 将会从无障碍树中移除它。这将导致该元素及其所有后代元素不再通过屏幕阅读器技术展示。
如果你想要从视觉上隐藏元素,一个更好的替代方案是使用属性的组合将其直观地从屏幕删除,但是通过屏幕阅读器等辅助技术依然可以解析。
display: contents当前在大多数浏览器的实现是将任意 display 值为 contents 的元素从无障碍树中移除(但是保留后代元素)。这将导致该元素自身不再通过屏幕阅读器技术展示。根据 CSS 规范,这是错误的行为。
更多带有 display: contents 的无障碍标记 | Hidde de Vries
Display: 内容不是 CSS 重置 | Adrian Roselli
表格有些浏览器,将
元素的 display 值改为 block、grid 或 flex,这将改变它在无障碍树中的显示。这将导致表格不再通过屏幕阅读技术展示。
关于 CSS display 属性对表格语义的影响的简短说明——The Paciello Group
隐藏内容以获得更好的无障碍 | Go Make Things
MDN 理解 WCAG,指南 1.3 解释
了解成功标准 1.3.1 | W3C 理解 WCAG 2.0
形式定义初始值inline适用元素所有元素是否是继承属性否计算值为指定的值,但定位元素、浮动元素和根元素除外。在这两种情况下,计算值可能是不同于指定值的其他关键字。动画类型离散行为,但如果动画过渡以 none 开始或结束,则其在整个持续时间内都是可见的形式语法display = [ || ] | | | | | || [ | math ] = block | inline | run-in = flow | flow-root | table | flex | grid | ruby = ? && [ flow | flow-root ]? && list-item = table-row-group | table-header-group | table-footer-group | table-row | table-cell | table-column-group | table-column | table-caption | ruby-base | ruby-text | ruby-base-container | ruby-text-container = contents | none = inline-block | inline-table | inline-flex | inline-grid
Sources: CSS Display Module Level 4, MathML Core示例比较 display 的值在这个示例中,我们有两个块级的容器元素,每个元素有三个行级子元素。在下面,我们有一个选择菜单,允许你将不同的 display 值应用于容器,允许你去比较和对比不同的值如何影响元素及其他们子元素的布局。
我们在容器上以及它们的子元素中使用了 padding 和 background-color,以便更容易看到 display 值的影响。
HTML
html
一
二
三
一
二
三
选择一个 display 值:
block
inline
inline-block
inline flow-root
none
flex
inline-flex
inline flex
grid
inline-grid
inline grid
table
block table
list-item
CSS
csshtml {
font-family: helvetica, arial, sans-serif;
letter-spacing: 1px;
padding-top: 10px;
}
article {
background-color: red;
}
article span {
background-color: black;
color: white;
margin: 1px;
}
article,
span {
padding: 10px;
border-radius: 7px;
}
article,
div {
margin: 20px;
}
JavaScript
jsconst articles = document.querySelectorAll(".container");
const select = document.querySelector("select");
function updateDisplay() {
articles.forEach((article) => {
article.style.display = select.value;
});
}
select.addEventListener("change", updateDisplay);
updateDisplay();
结果
请注意,为了便于说明,添加了一些多关键字值,下面这些值是相等的。
inline-block = inline flow-root
inline-flex = inline flex
inline-grid = inline grid
table = block table
你可以在分组的值上找到上面链接的每个单独 display 数据类型的更多示例。
规范SpecificationCSS Display Module Level 3 # the-display-propertiesScalable Vector Graphics (SVG) 2 # VisibilityControl浏览器兼容性参见
常规流中的块向和行向布局
格式化上下文简介
visibility、float、position
grid、flex