前端投影片
建立零依賴、動畫豐富的 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不可用,詢問是要安裝它,還是退回手動/匯出式工作流程。 - 保留投影片順序、演講者備註與萃取的資產。
- 萃取後,執行與新簡報相同的風格選擇工作流程。
保持轉換跨平台。不要依賴僅限 macOS 的工具,當 Python 可以完成工作時。
實作需求
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:如果需要自動化瀏覽器驗證最終簡報
交付檢查清單
- 簡報可從本機檔案在瀏覽器中執行
- 每個投影片都適應視窗且無捲動
- 風格獨特且有目的性
- 動畫有意義而非嘈雜
- 尊重減少動畫
- 交接時解釋檔案路徑與自訂要點