フロントエンドスライド
ゼロ依存で、ブラウザ上で完全に動作するアニメーション豊かなHTMLプレゼンテーションを作成します。
zarazhangrui氏の作品で示された視覚的探索アプローチに着想を得ています(クレジット: @zarazhangrui)。
アクティベートするタイミング
- トークデッキ、ピッチデッキ、ワークショップデッキ、または社内プレゼンテーションを作成する場合
.pptまたは.pptxスライドをHTMLプレゼンテーションに変換する場合- 既存のHTMLプレゼンテーションのレイアウト、モーション、タイポグラフィを改善する場合
- デザインの好みが不明なユーザーとプレゼンテーションスタイルを探索する場合
譲れない条件
- ゼロ依存: デフォルトでは、インラインCSSとJSを含む単一の自己完結型HTMLファイルとします。
- ビューポート適合は必須: 各スライドは内部スクロールなしで1つのビューポート内に収まらなければなりません。
- 説明ではなく表示: 抽象的なスタイルアンケートではなく、視覚的なプレビューを使用します。
- 特徴的なデザイン: 一般的なパープルグラデーション、Inter on White、テンプレート風のデッキは避けます。
- プロダクション品質: コードはコメント化、アクセシブル、レスポンシブ、パフォーマンスを維持します。
生成前に、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
- reduced-motion対応
5. ビューポート適合を徹底
これを厳格なゲートとして扱います。
ルール:
- すべての
.slideはheight: 100vh; height: 100dvh; overflow: hidden;を使用する必要があります。 - すべてのタイプとスペーシングは
clamp()でスケーリングする必要があります。 - コンテンツが収まらない場合は、複数のスライドに分割します。
- テキストを読み取り可能なサイズ以下に縮小することでオーバーフローを解決しないでください。
- スライド内にスクロールバーを許可しないでください。
STYLE_PRESETS.md の密度制限と必須CSSブロックを使用します。
6. 検証
完成したデッキを以下のサイズでチェックします。
- 1920x1080
- 1280x720
- 768x1024
- 375x667
- 667x375
ブラウザ自動化が利用可能な場合は、それを使用してスライドのオーバーフローがなく、キーボードナビゲーションが機能することを確認します。
7. 引き渡し
引き渡し時:
- ユーザーが保持を希望しない限り、一時的なプレビューファイルを削除します。
- 有用な場合は、プラットフォームに適したオープナーでデッキを開きます。
- ファイルパス、使用したプリセット、スライド数、簡単なテーマカスタマイズポイントを要約します。
現在のOSに適したオープナーを使用します。
- 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画像 |
アンチパターン
- ビジュアルアイデンティティのない一般的なスタートアップグラデーション
- 意図的にエディトリアルでない限り、システムフォントのデッキ
- 長い箇条書きの壁
- スクロールが必要なコードブロック
- 短い画面で壊れる固定高さのコンテンツボックス
-clamp(...)のような無効な否定CSS関数
関連ECCスキル
frontend-patterns: デッキ周辺のコンポーネントとインタラクションパターン用liquid-glass-design: プレゼンテーションが意図的にAppleのガラス美学を借用する場合e2e-testing: 完成したデッキの自動ブラウザ検証が必要な場合
成果物チェックリスト
- プレゼンテーションがローカルファイルからブラウザで実行される
- すべてのスライドがスクロールなしでビューポートに収まる
- スタイルが特徴的で意図的である
- アニメーションが意味があり、うるさくない
- reduced-motionが尊重されている
- 引き渡し時にファイルパスとカスタマイズポイントが説明されている