纯CSS弹窗动画需用visibility+opacity+transform组合，禁用display；原生dialog须弃用showModal()改用show()+自定义backdrop；触发动画前需offsetWidth强制重排；移动端须加will-change和translate3d启用GPU加速。

用 CSS @keyframes 实现弹窗进入动画，不依赖 JS 控制显隐

纯 CSS 动画必须和元素的显示/隐藏状态解耦——display: none 会中断动画，所以不能直接对 display 做过渡。正确做法是：用 visibility + opacity + transform 组合控制「视觉上的出现」，同时用 JS 切换类名来触发动画。

• 进入动画阶段：先设 visibility: visible，再通过 opacity 和 transform 过渡（比如 scale(0.9) → scale(1)）
• 退出动画阶段：动画结束后再把 visibility 设为 hidden，否则用户可能点不到关闭按钮（因为 visibility: hidden 仍占布局空间但不可交互）
• 关键限制：transition 不支持 display，也不支持 visibility 的「延迟隐藏」，必须靠 animationend 事件或 setTimeout 手动清理

modal.showModal() 无法加 CSS 进入动画？那是没绕过它的默认行为

原生 <dialog></dialog> 的 showModal() 会立即设 display: block 并阻塞交互，导致你写的 transition 失效。解决办法是：不用 showModal() 直接调用，改用 show() + 自定义 backdrop + 手动 trap focus。

• 给 <dialog></dialog> 加 open 属性后，用 transition: opacity 0.3s, transform 0.3s 配合 transform: scale(0.95) 初始态
• 背板（backdrop）需单独写 dialog::backdrop，并确保它也有 transition: opacity，否则会出现「弹窗闪一下才淡入」
• 注意 Safari 对 dialog::backdrop 的 transition 支持不完整，建议加 -webkit-backdrop-filter: blur(2px) 提升质感，同时 fallback 到纯色背景

JS 触发动画时，offsetWidth 强制重排是必要操作

直接加类名后立刻执行动画，浏览器可能合并样式计算，导致第一帧被跳过。必须在添加动画类后、触发动画属性前，强制触发一次 layout。

htmlppt.skill

把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。

下载

• 典型写法：

  modal.classList.add('is-opening');
  modal.offsetWidth; // 强制重排，让浏览器“看到”初始态
  modal.classList.add('is-open');

• 如果用 requestAnimationFrame 替代 offsetWidth，要注意两次 rAF 才能确保生效（第一次 flush style，第二次开始动画），不如 offsetWidth 直观可靠
• 退出时同理：先加 is-closing 类，再 offsetWidth，再移除 is-open —— 否则动画还没开始，元素就消失了

移动端弹窗动画卡顿？检查 will-change 和 transform 3D 提升

iOS Safari 和部分安卓 WebView 对非合成层动画渲染极差，尤其是带 opacity + transform 的组合。不加优化，60fps 很难维持。

立即学习“前端免费学习笔记（深入）”；

• 给弹窗容器加 will-change: transform, opacity，但别滥用——只在动画开始前加，结束立即移除，否则内存占用高
• 用 transform: translateZ(0) 或 translate3d(0,0,0) 强制 GPU 加速，比纯 translateY 更稳
• 避免在动画中读取 getBoundingClientRect() 或频繁修改 scrollTop，这些会强制同步 layout，打断合成器流水线

实际效果是否顺滑，取决于「动画属性是否可合成」+「JS 是否干扰渲染主线程」。很多所谓“兼容方案”只是掩盖了重排问题，而不是真正解决。