前端样式-弹窗淡入淡出,为什么你的 `transition` 一直不生效

0 阅读15分钟

先看三个场景,你大概踩过其中一个:

  • 弹窗打开是淡入加缩放,挺精致;点关闭,「啪」一下没了,完全没有淡出。
  • 你照着教程抄了 transition: display .3s allow-discrete,结果进场有动画、退场没有。
  • 三件套都写了,某个弹窗退场还是瞬变——查了半天,是两行代码的顺序写反了。

这三件事的根子是同一个:display: none 的元素没有盒子,没有盒子就没有中间帧。opacity 从 1 到 0 的过程,发生在「元素已经消失」之后,浏览器不是偷懒,是按规范算对了。

2023 年 Chrome 117 起这件事有解:transition-behavior: allow-discrete 让离散属性参与过渡,@starting-style 补上「进场第一帧长什么样」。两者在 2024-08-06 一起进了 Baseline。但成文教程大多只给一行 transition: display .3s allow-discrete 就说"这样就可以了",读者照抄后往往发现只亮了一半。

这篇把三件套逐件拆开,每个结论都给 Chrome 152 的实测帧数。所有测试都是同一张静态页面加 Puppeteer,每帧读 getComputedStyle 的 display 与 opacity,时长统一 0.4s,采样 500ms,中间帧指 opacity 严格落在 0.02 与 0.98 之间的帧。

先看这张表:进场和退场,是两套机制

五种写法,进和出要分开看:

写法transition-behavior 计算值进场中间帧退场中间帧
只写 opacity,display 直接切normal00
transition: display .4s(漏了 allow-discrete)normal, normal00
transition: opacity .4s allow-discrete(列表里没有 display)allow-discrete00
transition: display .4s allow-discrete, opacity .4s(没有 @starting-style)allow-discrete, normal019
上面再加 @starting-style { opacity: 0 }allow-discrete, normal1919

最值得注意的是第四行:进场 0 帧、退场 19 帧。这不是配置写错了一半,而是三件套各自管一件不同的事——少了第三件,只有退场能靠「元素当前已经渲染」这一点活下来。下一节开始逐件拆。

第一件:先把 display 写进过渡列表

看个场景

一个弹窗,你写了 transition: opacity .4s,display 从 none 切到 block。收起时读第一帧,display 已经是 none,opacity 也是 0——没有任何中间帧,元素在第一帧就消失了,过渡没有地方发生。

以前怎么写 / 现在怎么写

/* 以前:只过渡 opacity,display 瞬时切 */
.modal { transition: opacity .4s; }

/* 现在:把 display 也列进去 */
.modal {
  transition: opacity .4s, display .4s allow-discrete;
}

你会看到什么

transition 只过渡列表里列出来的属性。display 默认不在任何隐式列表里,transition: opacity .3s 的时候它根本不在场上,此时不论怎么调时长都是瞬时切换。

顺带回答一个高频疑问:transition: all 包含 display 吗? 包含。实测 .d { transition: all .4s allow-discrete } 加 @starting-style 后,进 19 帧、退 19 帧,与逐项列出的效果完全一致。但我不建议在生产里这么写:all 会把布局属性、transform、box-shadow 一起拉进来,任何一个属性在你没注意时改值,都会产生一次过渡。列出来更省心。

第二件:allow-discrete 是许可证,不是动画

看个场景

离散属性没有中间值,默认根本不参与过渡。allow-discrete 的作用是告诉浏览器:这个属性的变化按离散方式处理,允许它「挂在过渡里」。

你会看到什么

display 与一般的离散属性还不太一样。content-visibility 这类属性在两个值之间翻转发生在过渡的中点,而 display 是按方向特判的:

  • 从 none 到其他值:在 0% 处翻转,盒子立刻出现,整个进场过程中都可见;
  • 从其他值到 none:在 100% 处翻转,盒子一直留到退场结束才消失。

实测印证了这个不对称。三件套齐全的组,进场第一帧 display 就已经是 flex、opacity 是 0;退场时 display 一直是 flex,直到 394ms(时长 0.4s)才变成 none。这一个细节解释了整件事:退场有动画,是因为盒子被允许留到最后;进场需要起点,是因为盒子刚出现时没有「前一个值」。

那为什么进场会「瞬变」?因为第一次渲染的元素不触发过渡——规范里叫「不存在的初始样式」。这正是第三件要解决的。

第三件:@starting-style 告诉浏览器第一帧长什么样

看个场景

弹窗刚打开时,opacity 直接从 0 跳到 1,看不到渐变。因为它是第一次获得样式,浏览器没有「上一个值」可以过渡。

以前怎么写 / 现在怎么写

.modal { display: none; opacity: 0; transition: opacity .3s, display .3s allow-discrete; }
.modal[open] { display: block; opacity: 1; }

/* 以前:到这里就结束,进场瞬变 */

/* 现在:补上起点 */
@starting-style { .modal[open] { opacity: 0; } }

你会看到什么

@starting-style 里写的声明,只在元素第一次获得样式、或者 display 从 none 变成其他值时生效,用来充当过渡的起点。写法上要匹配「打开后」的状态选择器。

实测对照非常干净:去掉这一条,进场首帧 opacity 就是 1,中间帧 0 个;加上之后,首帧是 0,慢慢爬到 1,中间帧 19 个。退场两组都是 19 帧——所以「退场动画需不需要 @starting-style」的答案是:不需要。 退场时元素还在,起点就是它当前的计算值,没有「第一次渲染」的问题。

这条结论很有用,它意味着 @starting-style 不是「双向动画的开关」,只负责进场。发现自己写的弹窗「出得来、回不去」或者「回得去、出不来」,第一件事应该是分清缺的是哪一件,而不是把三件套再抄一遍。

五个写法看着对,动画却悄悄没了

三件套写对了只是及格线。下面五条都不会报错,控制台一行提示都没有,但效果会打折甚至归零。

一、behavior 写在简写前面,会被重置

/* 错误:简写会把前面的 behavior 一起重置 */
.x { transition-behavior: allow-discrete; transition: display .4s, opacity .4s; }

/* 正确:换到简写之后 */
.x { transition: display .4s, opacity .4s; transition-behavior: allow-discrete; }

实测错误写法的 transition-behavior 计算值是 normal, normal,allow-discrete 没了。后果很有欺骗性:进场仍有 19 帧(因为 @starting-style 还在,opacity 照常过渡),退场 0 帧、首帧 display 就是 none。

也就是说,它表现出的症状恰好是「进场有、退场没有」,跟「漏了 @starting-style」正好相反。这两个症状是排查时的第一分叉:

你看到的症状缺的东西
进场瞬变、退场正常缺 @starting-style,或它的选择器没匹配上
进场正常、退场瞬变allow-discrete 没生效(被简写重置、或属性没列进列表)

把 transition-behavior 挪到简写之后,计算值变成 allow-discrete,退场立刻回到 19 帧。

二、@starting-style 放错位置,会被目标规则盖掉

/* 失效:两条特异性都是 0,2,0,后写的 .on 赢 */
@starting-style { .panel.on { opacity: 0; } }
.panel { transition: display .4s allow-discrete, opacity .4s; opacity: 0; }
.panel.on { opacity: 1; }

/* 修法:把 @starting-style 挪到目标规则之后 */
.panel { transition: display .4s allow-discrete, opacity .4s; opacity: 0; }
.panel.on { opacity: 1; }
@starting-style { .panel.on { opacity: 0; } }

实测失效写法进场 0 帧、首帧 opacity 就是 1;把 @starting-style 挪到 .panel.on 之后,进场变成 19 帧。进场的起点值被目标规则盖掉了,于是「起点等于终点」,没有可过渡的差值。

修法有两个:放到目标规则之后,或者让里面的选择器特异性更高(比如多带一个属性选择器)。前者更稳,也更好读。

三、一个值不认识,整条声明全丢

这一条是降级时的大坑。假设浏览器不认识 allow-discrete,你写的是:

.modal { transition: display .3s allow-discrete, opacity .3s; }

很多人以为「不认识 allow-discrete,那就退化成 opacity 过渡」。实测不是。用一条确定无效的值替代来模拟:transition: display .4s nonsense-value, opacity .4s,读出来的计算值是 transition-property: all、transition-duration: 0s、transition-behavior: normal——整条声明被丢弃,连 opacity 的过渡都一起没了。

/* 正确:用 @supports 分层,让老浏览器拿到干净的 opacity 声明 */
.modal { transition: opacity .3s; }
@supports (transition-behavior: allow-discrete) {
  .modal { transition: opacity .3s, display .3s allow-discrete; }
}

实测这组在支持的环境下进 19 帧、退 19 帧,与直接写三件套一致;不支持的环境则拿到 opacity 过渡,元素照常显示与隐藏。

四、基础规则写 display: flex,把「关闭」盖掉了

/* 错误:这条让关闭状态的 dialog 也是 flex */
dialog { display: flex; }

<dialog> 关闭时的 display: none 来自浏览器默认样式。作者在基础选择器上写 display: flex,特异性更高,直接把它盖掉。实测关闭后(open 属性已移除)元素仍是 display: flex、高度 60px,肉眼可见地停在页面上。

要居中就直接用 dialog 自带的 margin: auto,或者在里面套一层容器再上 Flex 与 Grid。

五、::backdrop 不会跟着父元素一起动

弹窗的背后遮罩也是顶层盒,只给它写 background-color 的过渡,收起时会瞬拍变透明。实测:只写 transition: background-color .4s 的那一组,关闭过程中读到的背景色只有一种(rgba(0, 0, 0, 0)),没有中间值。

给 ::backdrop 补上 display 与 overlay 的 allow-discrete 之后,同一段过渡里读到 23 种不同的背景色,从 rgba(0, 0, 0, 0.6) 平滑落到透明:

.modal::backdrop {
  background-color: rgba(0, 0, 0, 0);
  transition: background-color .3s, display .3s allow-discrete, overlay .3s allow-discrete;
}
.modal[open]::backdrop { background-color: rgba(0, 0, 0, .6); }
@starting-style { .modal[open]::backdrop { background-color: rgba(0, 0, 0, 0); } }

用 background-color 而不是 opacity,是为了让底色与时序待在同一个声明里,不用再为 opacity 补一套起止值。

顶层元素还有第四件:overlay

看个场景

<dialog> 和 popover 打开时会被放进顶层(top layer),关闭时被移出。这个移出动作和 display 一样是瞬时的,而且它比 display 更早——元素离开顶层的那一刻就掉回普通文档流,位置、层叠次序、被父元素裁剪的状态全部变回去。后面 opacity 就算还在过渡,观众看到的也是一块掉到页面中间的半透明方块。

overlay 这个属性你不能设置,只有浏览器能改;你能做的是把它列进 transition-property,让「移出顶层」这一步被推迟到过渡结束。

你会看到什么

实测两组对照,都在关闭后逐帧记录元素的实际矩形与 overlay 计算值:

写法关闭后位置序列overlay 计算值说明
只有 display + opacity350,340 → 350,16 → 0,0全程 none125ms 时就掉回文档流顶部
再加 overlay .4s allow-discrete350,340 一直到 0,0auto 保持到 389ms 才变 none位置在整个退场里没动

两个数字值得记住:不加 overlay,元素在关闭后约 125ms(第一帧之后)就跳到了 y=16;加了之后,它在 400ms 的退场全过程里一直停在 y=340。这不是「视觉上更顺」的问题,是「元素还在不在原处」的问题。

顺带纠正一个容易误用的判据:不要用 :modal 判断元素是否还在顶层。实测关闭的瞬间 :modal 就变成 false,但加了 overlay 的那一组元素明明还留在顶层完整走完了退场。:modal 匹配的是「打开的模态对话框」,关闭动作一发生它就不再匹配,与顶层移除是两件事。

<dialog> 与 popover 在这一条上表现一致,都需要 overlay。区别只在触发方式:dialog 用 close(),popover 用 hidePopover() 或点击外部。

快速连点会不会卡在中间态

规划阶段我把这条列为必测:过渡没走完就反向,元素会不会停在半透明。

实测:0.4s 的过渡,每 100ms 切换一次显示/隐藏,连切 10 次,同时每帧采样。结果是 opacity 在 0.36 到 0.96 之间来回反转,整个过程有 67 帧落在中间值,最后一次切换后 900ms 末态是 display: flex / opacity: 1,收敛正确。

结论是不会卡死。CSS 过渡被打断时从当前计算值继续往新目标走,不会排队、不会累加,这也意味着连点期间观众看到的是「来回抖」,而不是「卡住」。如果这个抖动对体验有影响,能调的不是 transition 的写法,而是时长本身:退场做短一些(比如 0.2s),让下一次点击到达时元素多半已经落地。

真正会「卡住」的是 JS 侧:如果你在 transitionend 里做事(卸载组件、解锁滚动、移除类名),连点时事件可能因为过渡被打断而少发。这一条与 CSS 无关,但同一个弹窗里往往两个问题一起出现——CSS 这边看起来「动画正常」,JS 那边滚动条锁死了。

兼容:四个能力不是一起进 Baseline 的

这是最容易写错的一段,因为四个能力进 Baseline 的时间并不一致:

能力ChromeEdgeFirefoxSafariBaseline
transition-behavior: allow-discrete11711712917.42024-08-06 新近可用
@starting-style11711712917.52024-08-06 新近可用
display 属性本身可过渡117117未标注18—
overlay 属性117117不支持不支持未进入

前三行的差别是关键:「语法被认识」和「display 真的能过渡」是两件事。Safari 17.4 就有了 transition-behavior,17.5 有了 @starting-style,但把两者配合起来给 display 做过渡,要到 Safari 18 才成立;Firefox 129 起两项语法都可用,而 display 过渡至今没有标注支持。

这两处口径我核了两个来源:BCD 8.1.9(2026-11-17)里 css.properties.display.transitionable_display 只标了 Chrome 117、Edge 117、Safari 18;另一份 2026 年中的英文综述结论一致。都属于二手资料,所以我标成待实机复核,而不是定论。真要在老 Safari 或 Firefox 上依赖它,跑一次进退比查表可靠。

overlay 更单纯:只有 Chromium 有,MDN 仍标为实验性,没有进 Baseline。它属于典型渐进增强——不支持时元素照样开关,只是退场会掉回文档流位置。

由此得出降级策略:能降的只有动画,不能降的是可用性。 三件套失效时元素仍然照常显示与隐藏,这一点由 @supports 那一层兜住(见上一节第三条)。要避开的唯一硬伤是那条「整条声明被丢弃」——它会让本来能用的 opacity 过渡一起消失。

一份能直接抄的弹窗

把前面所有约束合起来,就是一个不带花活但方向正确的版本:

.modal {
  /* 关闭态:display 由浏览器默认样式给出,这里只写可见性 */
  opacity: 0;
  transition: opacity .3s, display .3s allow-discrete, overlay .3s allow-discrete;
  transition-behavior: allow-discrete; /* 放在简写之后,不会被重置 */
}
.modal[open] { opacity: 1; }
@starting-style { .modal[open] { opacity: 0; } }

.modal::backdrop {
  background-color: rgba(0, 0, 0, 0);
  transition: background-color .3s, display .3s allow-discrete, overlay .3s allow-discrete;
}
.modal[open]::backdrop { background-color: rgba(0, 0, 0, .6); }
@starting-style { .modal[open]::backdrop { background-color: rgba(0, 0, 0, 0); } }

三个细节:基础规则里不写 display,让浏览器默认的 dialog:not([open]) { display: none } 保留;transition-behavior 独立成行且放在简写之后,同时管住 display 与 overlay 两条;::backdrop 单独一套,不要指望它跟着父元素走。

如果项目还要跑在不支持的环境,就在外面包一层:

@supports not (transition-behavior: allow-discrete) {
  .modal { transition: opacity .3s; }
  .modal::backdrop { transition: background-color .3s; }
}

判据:缺一件,不如不写

写到这里可以收成一句话:进场靠 @starting-style 给起点,退场靠 display 与 overlay 的 allow-discrete 拖住终点,两个方向是两套机制,必须分别验证。

落到日常,我用的检查顺序是:

  1. 先看方向:进场瞬变还是退场瞬变。前者查 @starting-style 与它的选择器顺序,后者查 transition-behavior 有没有被简写重置。
  2. 再看列表:display 在不在 transition-property 里,overlay 在不在(顶层元素才需要)。
  3. 最后看降级:有没有 @supports 那一层,确保老浏览器拿到的是一条干净的、只含可插值属性的声明。
  4. 只做进场不做退场,不如不做。 单向动画会让「打开」显得精致、「关闭」显得廉价,同一个组件里两种手感,比两边都干脆更伤。

至于兼容,transition-behavior 与 @starting-style 已经新近可用,可以按「有就更好、没有也不坏」的方式上线;overlay 和「display 真的能过渡」这两项要按目标浏览器的实测结果决定是否依赖,别只看 CSS.supports 返回的 true——本机 Chrome 里 CSS.supports('overlay', 'auto') 是 true,但这只能证明「本机能解析」,跟 Firefox、Safari 一点关系都没有。

最后回到开头那个弹窗。它的问题从来不是「动画写得不够好」,而是把一件需要三处配合的事当成了一处:transition 管时长,display 需要许可证,第一帧需要起点,顶层元素还需要一个人拖住它别提前离场。四处都到位,display: none 才真的成为一个可以过渡的值。