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>你好,世界</h1>
</div>
</div>
</div>
</body>
</html>
画布元标签
| 标签 | 默认值 | 说明 |
|---|
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 | 时间 | duration 的替代属性 |
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="你好,欢迎观看演示。" data-hf-start="1s" />
时间格式
所有时间值均使用 CSS 风格的表示法:0s、1.5s、2000ms。允许使用小数秒。
验证
npx hyperframes lint index.html