HyperFrames Core — Contrat de Composition
Squelette 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>Bonjour le monde</h1>
</div>
</div>
</div>
</body>
</html>
Balises Méta du Canevas
| Balise | Valeur par défaut | Notes |
|---|
hf:canvas-width | 1920 | pixels |
hf:canvas-height | 1080 | pixels |
hf:fps | 30 | images par seconde |
hf:duration | auto | total ; ou explicite ex. 60s |
hf:bg-color | #000 | fond de scène par défaut |
Attributs de Scène (data-hf-scene)
| Attribut | Type | Description |
|---|
data-hf-scene | chaîne | nom / id de la scène |
data-hf-duration | temps | 5s, 10s, auto |
data-hf-transition | chaîne | cut, fade, slide-left, slide-right, zoom |
data-hf-transition-duration | temps | par défaut 0.5s |
data-hf-bg | url ou couleur | fond de scène |
Attributs de Piste (data-hf-track)
| Attribut | Type | Description |
|---|
data-hf-track | chaîne | nom de la piste |
data-hf-z | nombre | empilement z-index |
data-hf-mute | booléen | couper le son sur cette piste |
Attributs de Clip (data-hf-clip)
| Attribut | Type | Description |
|---|
data-hf-clip | — | marque l'élément comme un clip |
data-hf-start | temps | décalage de début dans la scène |
data-hf-duration | temps | durée du clip ; auto = durée du contenu |
data-hf-end | temps | alternative à la durée |
data-hf-animate | chaîne | préréglage d'animation abrégé |
data-hf-in | chaîne | animation d'entrée |
data-hf-out | chaîne | animation de sortie |
data-hf-volume | 0–1 | volume audio |
data-hf-speed | nombre | multiplicateur de vitesse de lecture |
data-hf-loop | booléen | boucler le média |
data-hf-trim-start | temps | couper le média depuis le début |
data-hf-trim-end | temps | couper le média à la fin |
Clips Média
<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="Bonjour, bienvenue dans la démo." data-hf-start="1s" />
Format Temporel
Toutes les valeurs temporelles utilisent la notation CSS : 0s, 1.5s, 2000ms. Les secondes fractionnaires sont autorisées.
Validation
npx hyperframes lint index.html