HyperFrames 轨道与剪辑(Tracks and Clips)完全指南:用data-start掌控合成时间轴
【免费下载链接】hyperframesWrite HTML. Render video. Built for agents.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes
本指南以 HyperFrames 技能文档 skills/hyperframes-core/references/tracks-and-clips.md 为主体,深入讲解剪辑(Clip)与轨道(Track)两大核心概念:剪辑是合成(composition)内的定时元素,轨道则是 Studio 时间轴的纯显示概念。读完本文,你将掌握如何用data-start/data-duration/data-track-index精确编排任意元素(场景、卡片、视频、音频、图片、子合成),理解相对时间引用的全部规则与静默失败陷阱,并能用npx hyperframes lint守住可渲染的底线。
什么是 Clip(剪辑)
在 HyperFrames 中,剪辑就是任何带有data-start属性的 DOM 元素;需要结束时间时再加data-duration。data-track-index是可选的。运行时通过收集[data-start]来驱动元素的可见性——正是这个属性把一个普通元素变成"定时元素"。这一点与 skills/hyperframes-core/references/data-attributes.md 中的 Clip 属性表完全一致:"data-start就是让元素成为剪辑的那个属性"。
常见剪辑种类及其data-duration要求:
| 剪辑类型 | 元素 | data-duration要求 |
|---|---|---|
| 视觉剪辑(场景、卡片、叠加层) | <div> | 始终需要 |
| 子合成宿主 | <div><video id="intro" contenteditable="false">【免费下载链接】hyperframesWrite HTML. Render video. Built for agents. |