前端幻灯片
创建零依赖、动画丰富的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[presentation-name].html
仅当幻灯片包含提取的或用户提供的图像时,才使用 assets/ 文件夹。
必需结构:
- 语义化的幻灯片区块
- 来自
STYLE_PRESETS.md的视口安全CSS基础 - 用于主题值的CSS自定义属性
- 用于键盘、滚轮和触摸导航的演示控制器类
- 用于显示动画的Intersection Observer
- 减少运动支持
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:当演示文稿有意采用Apple玻璃美学时e2e-testing:如果需要自动化浏览器验证最终的幻灯片
交付检查清单
- 演示文稿从本地文件在浏览器中运行
- 每个幻灯片适应视口,无需滚动
- 风格独特且有意为之
- 动画有意义,不杂乱
- 尊重减少运动
- 在交接时解释文件路径和自定义点