前端幻灯片
创建零依赖、动画丰富的HTML演示文稿,完全在浏览器中运行。
灵感来源于 zarazhangrui(致谢:@zarazhangrui)展示的视觉探索方法。
何时激活
- 创建演讲幻灯片、产品推介幻灯片、工作坊幻灯片或内部演示文稿
- 将
.ppt或.pptx幻灯片转换为 HTML 演示文稿 - 改进现有 HTML 演示文稿的布局、动画或排版
- 帮助尚不清楚设计偏好的用户探索演示样式
不可妥协的要求
- 零依赖:默认生成一个自包含的 HTML 文件,内联 CSS 和 JS。
- 视口适配是强制性的:每张幻灯片必须恰好适配一个视口,且无内部滚动。
- 展示而非说明:使用视觉预览代替抽象的风格问卷。
- 独特设计:避免通用的紫色渐变、Inter字体配白底、模板化的幻灯片。
- 生产质量:代码应包含注释、可访问、响应式且性能良好。
在生成之前,请阅读 STYLE_PRESETS.md 以获取视口安全 CSS 基础、密度限制、预设目录和 CSS 陷阱。
工作流程
1. 检测模式
选择一条路径:
- 新建演示文稿:用户有主题、笔记或完整草稿
- PPT 转换:用户有
.ppt或.pptx文件 - 增强:用户已有 HTML 幻灯片并希望改进
2. 探索内容
仅询问最少必要信息:
- 目的:产品推介、教学、会议演讲、内部更新
- 长度:短(5-10页)、中(10-20页)、长(20页以上)
- 内容状态:完成稿件、粗略笔记、仅有主题
如果用户有内容,请在样式设计前要求用户粘贴内容。
3. 探索风格
默认采用视觉探索。
如果用户已经知道想要的预设,则跳过预览,直接使用该预设。
否则:
- 询问用户希望演示文稿传达何种感受:令人印象深刻、充满活力、专注、鼓舞人心。
- 在
.ecc-design/slide-previews/目录中生成 3 个单页幻灯片预览文件。 - 每个预览必须是自包含的,清晰展示排版、色彩和动画,并控制在约 100 行幻灯片内容以内。
- 询问用户保留哪个预览或混合哪些元素。
根据情绪映射风格时,请参考 STYLE_PRESETS.md 中的预设指南。
4. 构建演示文稿
输出以下文件之一:
presentation.html[演示文稿名称].html
仅当幻灯片中包含提取的或用户提供的图片时,才使用 assets/ 文件夹。
必需的结构:
- 语义化的幻灯片节(section)
- 来自
STYLE_PRESETS.md的视口安全 CSS 基础 - 用于主题值的 CSS 自定义属性
- 用于键盘、滚轮和触摸导航的演示文稿控制器类
- 用于显示动画的 Intersection Observer
- 减少动画支持(
prefers-reduced-motion)
5. 强制视口适配
将此视为硬性关卡。
规则:
- 每个
.slide必须使用height: 100vh; height: 100dvh; overflow: hidden; - 所有文字和间距必须使用
clamp()进行缩放 - 当内容无法适配时,拆分为多个幻灯片
- 永远不要通过将文字缩小到可读尺寸以下来解决溢出问题
- 绝不允许幻灯片内出现滚动条
使用 STYLE_PRESETS.md 中的密度限制和强制 CSS 块。
6. 验证
在以下尺寸检查完成的幻灯片:
- 1920x1080
- 1280x720
- 768x1024
- 375x667
- 667x375
如果浏览器自动化工具可用,请使用它来验证没有幻灯片溢出,并且键盘导航正常工作。
7. 交付
移交时:
- 删除临时预览文件,除非用户希望保留
- 在适用时,使用平台对应的打开工具打开幻灯片
- 汇总文件路径、使用的预设、幻灯片数量以及简单的主题自定义点
使用当前操作系统对应的打开工具:
- macOS:
open file.html - Linux:
xdg-open file.html - Windows:
start "" file.html
PPT / PPTX 转换
对于 PowerPoint 转换:
- 优先使用
python3和python-pptx来提取文本、图片和备注。 - 如果
python-pptx不可用,询问用户是安装它还是回退到手动/基于导出的工作流程。 - 保留幻灯片顺序、演讲者备注和提取的素材。
- 提取后,运行与新建演示文稿相同的风格选择工作流程。
确保转换跨平台。当 Python 可以胜任时,不要依赖仅在 macOS 上可用的工具。
实现要求
HTML / CSS
- 除非用户明确要求多文件项目,否则使用内联 CSS 和 JS。
- 字体可来自 Google Fonts 或 Fontshare。
- 优先使用氛围背景、强大的字体层级和清晰的视觉方向。
- 使用抽象形状、渐变、网格、噪点和几何图形,而不是插图。
JavaScript
包含:
- 键盘导航
- 触摸/滑动导航
- 鼠标滚轮导航
- 进度指示器或幻灯片索引
- 进入时触发展示动画
无障碍访问
- 使用语义化结构(
main、section、nav) - 保持对比度可读
- 支持仅键盘导航
- 尊重
prefers-reduced-motion
内容密度限制
除非用户明确要求更密集的幻灯片且可读性仍能保持,否则使用以下最大值:
| 幻灯片类型 | 限制 |
|---|---|
| 标题页 | 1 个标题 + 1 个副标题 + 可选标语 |
| 内容页 | 1 个标题 + 4-6 个要点或 2 个短段落 |
| 特性网格 | 最多 6 个卡片 |
| 代码页 | 最多 8-10 行 |
| 引用页 | 1 条引用 + 署名 |
| 图片页 | 1 张图片,受视口约束 |
反模式
- 没有视觉标识的通用启动渐变
- 系统字体幻灯片(除非是故意设计的编辑风格)
- 冗长的要点列表
- 需要滚动的代码块
- 在短屏上会断裂的固定高度内容框
- 无效的否定 CSS 函数,如
-clamp(...)
相关 ECC 技能
frontend-patterns:用于幻灯片周围的组件和交互模式liquid-glass-design:当演示文稿有意借鉴苹果玻璃美学时e2e-testing:如果需要自动浏览器验证最终幻灯片
交付清单
- 演示文稿可在浏览器中从本地文件运行
- 每张幻灯片都能适配视口,无需滚动
- 风格独特且有意图
- 动画有意义而非杂乱
- 尊重减少动画设置
- 移交时说明文件路径和自定义点