HyperFrames 核心 — 組成合約
HTML 骨架
<!DOCTYPE html>
<html data-hf-version="1">
<head>
<meta charset="UTF-8" />
<meta name="hf:canvas-width" content="1920" />
<meta name="hf:canvas-height" content="1080" />
<meta name="hf:fps" content="30" />
<meta name="hf:duration" content="auto" />
</head>
<body>
<div data-hf-scene="intro" data-hf-duration="5s">
<div data-hf-track="background">
<div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
style="background:#111;width:100%;height:100%;position:absolute;"></div>
</div>
<div data-hf-track="title">
<div data-hf-clip data-hf-start="0.5s" data-hf-duration="4s"
data-hf-animate="fade-in">
<h1>Hello World</h1>
</div>
</div>
</div>
</body>
</html>
Canvas 中繼標籤
| 標籤 | 預設值 | 備註 |
|---|
hf:canvas-width | 1920 | 像素 |
hf:canvas-height | 1080 | 像素 |
hf:fps | 30 | 每秒幀數 |
hf:duration | auto | 總時長;或明確指定如 60s |
hf:bg-color | #000 | 預設場景背景 |
場景屬性 (data-hf-scene)
| 屬性 | 類型 | 說明 |
|---|
data-hf-scene | 字串 | 場景名稱 / ID |
data-hf-duration | 時間 | 5s、10s、auto |
data-hf-transition | 字串 | cut、fade、slide-left、slide-right、zoom |
data-hf-transition-duration | 時間 | 預設 0.5s |
data-hf-bg | URL 或顏色 | 場景背景 |
軌道屬性 (data-hf-track)
| 屬性 | 類型 | 說明 |
|---|
data-hf-track | 字串 | 軌道名稱 |
data-hf-z | 數字 | z-index 層疊順序 |
data-hf-mute | 布林值 | 靜音此軌道的音訊 |
片段屬性 (data-hf-clip)
| 屬性 | 類型 | 說明 |
|---|
data-hf-clip | — | 將元素標記為片段 |
data-hf-start | 時間 | 在場景內的開始偏移量 |
data-hf-duration | 時間 | 片段持續時間;auto = 內容持續時間 |
data-hf-end | 時間 | 可替代持續時間 |
data-hf-animate | 字串 | 簡寫動畫預設 |
data-hf-in | 字串 | 入場動畫 |
data-hf-out | 字串 | 出場動畫 |
data-hf-volume | 0–1 | 音訊音量 |
data-hf-speed | 數字 | 播放速度倍率 |
data-hf-loop | 布林值 | 循環播放媒體 |
data-hf-trim-start | 時間 | 從開頭裁剪媒體 |
data-hf-trim-end | 時間 | 在結尾裁剪媒體 |
媒體片段
<video data-hf-clip data-hf-start="0s" src="assets/hero.mp4" />
<img data-hf-clip data-hf-start="0s" data-hf-duration="3s" src="assets/logo.png" />
<audio data-hf-clip data-hf-start="0s" src="assets/music.mp3" data-hf-volume="0.4" />
<div data-hf-clip data-hf-tts="Hello, welcome to the demo." data-hf-start="1s" />
時間格式
所有時間值使用 CSS 風格記法:0s、1.5s、2000ms。允許小數秒。
驗證
npx hyperframes lint index.html