前端投影片
建立零依賴、動畫豐富的 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:若你需要自動化瀏覽器驗證最終簡報
交付檢查清單
- 簡報可以從本地檔案在瀏覽器中執行
- 每張投影片都契合在視埠內,無需捲動
- 風格獨特且有意圖
- 動畫有意義且不雜亂
- 尊重減少動畫設定
- 在交付時說明檔案路徑和自訂點