Setting the file. One moment.
Caption Skin · Hyperframes Creative · heygen-com/hyperframes · Skills Docs
Back to the top of the page 22.10
Narration
(opens in a new tab)
frame-presets/code-editorial/ caption-skin.html
HTML · 224 lines · 8 KB
15 --cap-ink · --cap-canvas · --cap-accent · --cap-accent-2 · --font-display ·
16 --font-body · --cap-band-top · --cap-band-height
17 Hooks (do not rename): .caption-group / .caption-word + states .is-active / .is-spoken,
18 root data-composition-id="captions", timeline at window.__timelines["captions"].
19 State changes use gsap.set({className}) (applied on the engine's frame-by-frame seek);
20 never tl.call() callbacks (seek does not fire them → wrong state on render).
21
22 Visual: a warm cream card lifted off the page on a 1px hairline ink border + one soft
23 warm shadow — code-editorial's only elevation language, no tilt, editorial and precise.
24 EB Garamond sentence case, warm-ink glyphs. Upcoming words sit in faint ink; the current
25 word reads in full ink under a 3px coral "voltage" underline (the brand's inline-link
26 gesture, border-bottom = underline without layout shift); spoken words settle to solid
27 ink, underline cleared.
28 -->
29 < script src = "https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js" ></ script >
30
31 <!-- captions.mjs injects the project's :root tokens here -->
32 < style data-brand-tokens ></ style >
33
34 < style >
35 #captions-root {
36 position : absolute ;
37 inset : 0 ;
38 pointer-events : none ;
39 }
40 .caption-layer {
41 position : absolute ;
42 inset : 0 ;
43 z-index : 20 ;
44 pointer-events : none ;
45 }
46 /* the keep-out band, from captionBand(H) — frame content stays above it */
47 .caption-stage {
48 position : absolute ;
49 left : 0 ;
50 right : 0 ;
51 top : var ( --cap-band-top , 900 px );
52 height : var ( --cap-band-height , 180 px );
53 display : flex ;
54 align-items : center ;
55 justify-content : center ;
56 }
57 .caption-group {
58 /* every group is absolutely stacked over the SAME band — exactly one shown at a
59 time via opacity. Must be absolute: in-flow groups would lay out side-by-side. */
60 position : absolute ;
61 inset : 0 ;
62 display : flex ;
63 align-items : center ;
64 justify-content : center ;
65 opacity : 0 ;
66 }
67
68 /* THE lifted cream card — warm cream fill, 1px hairline ink border, one soft warm
69 shadow (code-editorial's only elevation language), 12px radius, no tilt */
70 .caption-pill {
71 max-width : 78 % ;
72 padding : 22 px 44 px 26 px ;
73 background : var ( --cap-canvas , #faf9f5 );
74 border : 1 px solid color-mix ( in srgb , var ( --cap-ink , #141413 ) 12 % , transparent );
75 border-radius : 12 px ;
76 box-shadow :
77 0 1 px 3 px color-mix ( in srgb , var ( --cap-ink , #141413 ) 8 % , transparent ),
78 0 4 px 16 px color-mix ( in srgb , var ( --cap-ink , #141413 ) 4 % , transparent );
79 }
80 .caption-line {
81 display : flex ;
82 flex-wrap : wrap ;
83 justify-content : center ;
84 gap : 0.12 em 0.3 em ;
85 font-family : var ( --font-display , "EB Garamond" ), Georgia , serif ;
86 font-weight : 500 ;
87 font-size : clamp ( 40 px , 4.4 vw , 56 px );
88 line-height : 1.24 ;
89 letter-spacing : -0.02 em ;
90 }
91
92 /* upcoming — faint warm ink, no underline */
93 .caption-word {
94 display : inline-block ;
95 padding : 0 0.02 em 0.06 em ;
96 color : color-mix ( in srgb , var ( --cap-ink , #141413 ) 40 % , var ( --cap-canvas , #faf9f5 ));
97 border-bottom : 3 px solid transparent ;
98 }
99 /* current word — full ink under the coral voltage underline (the brand's signature
100 inline-link gesture; border-bottom = underline without layout shift) */
101 .caption-word.is-active {
102 color : var ( --cap-ink , #141413 );
103 border-bottom : 3 px solid var ( --cap-accent , #cc785c );
104 }
105 /* already spoken — solid warm ink, underline cleared */
106 .caption-word.is-spoken {
107 color : var ( --cap-ink , #141413 );
108 border-bottom : 3 px solid transparent ;
109 }
110
111 /* optional per-word accents (dormant until a word-classer tags them) */
112 /* brand / key term — the expressive EB Garamond italic */
113 .caption-word.cap-brand {
114 font-style : italic ;
115 color : var ( --cap-ink , #141413 );
116 }
117 .caption-word.cap-brand.is-active {
118 border-bottom : 3 px solid var ( --cap-accent , #cc785c );
119 }
120 /* numerals / data — slightly recessed warm ink */
121 .caption-word.cap-num {
122 color : color-mix ( in srgb , var ( --cap-ink , #141413 ) 72 % , var ( --cap-canvas , #faf9f5 ));
123 }
124 /* emphasis — a persistent coral voltage underline */
125 .caption-word.cap-cta {
126 border-bottom : 3 px solid var ( --cap-accent-2 , #b5654a );
127 color : var ( --cap-ink , #141413 );
128 }
129
130 @media ( max-aspect-ratio : 9 / 16 ) {
131 .caption-pill {
132 max-width : 92 % ;
133 }
134 .caption-line {
135 font-size : clamp ( 34 px , 5.4 vw , 46 px );
136 }
137 }
138 </ style >
139
140 < div
141 id = "captions-root"
142 data-composition-id = "captions"
143 data-timeline-locked
144 data-start = "0"
145 data-duration = "0"
146 data-fps = "30"
147 data-width = "0"
148 data-height = "0"
149 >
150 < div class = "caption-layer" aria-hidden = "true" >
151 < div id = "caption-stage" class = "caption-stage" ></ div >
152 </ div >
153 </ div >
154
155 < script >
156 // captions.mjs injects the engine's scene-aware groups + real duration here.
157 var GROUPS = [];
158 var DURATION = 0 ;
159
160 ( function () {
161 var stage = document. getElementById ( "caption-stage" );
162
163 // build DOM: one .caption-group per group, .caption-word per word
164 GROUPS . forEach ( function ( group , g ) {
165 var groupEl = document. createElement ( "div" );
166 groupEl.className = "caption-group" ;
167 groupEl.id = "caption-group-" + g;
168 var pill = document. createElement ( "div" );
169 pill.className = "caption-pill" ;
170 var line = document. createElement ( "div" );
171 line.className = "caption-line" ;
172 (group.words || []). forEach ( function ( w , i ) {
173 var span = document. createElement ( "span" );
174 span.className = "caption-word" ;
175 span.id = "caption-word-" + g + "-" + i;
176 span.textContent = String (w.text);
177 line. appendChild (span);
178 });
179 pill. appendChild (line);
180 groupEl. appendChild (pill);
181 stage. appendChild (groupEl);
182 });
183
184 window.__timelines = window.__timelines || {};
185 var tl = gsap. timeline ({ paused: true });
186
187 GROUPS . forEach ( function ( group , g ) {
188 var groupEl = document. getElementById ( "caption-group-" + g);
189 var words = group.words || [];
190 var next = GROUPS [g + 1 ];
191 var isLast = g === GROUPS . length - 1 ;
192 var start = Math. max ( 0 , Number (group.start));
193 var end = isLast ? DURATION : Math. min ( Number (next.start), Number (group.end) + 0.3 );
194 if (end <= start) end = start + 0.01 ;
195
196 // group on/off — exactly one group visible at a time
197 tl. set (groupEl, { opacity: 1 }, start);
198 tl. set (groupEl, { opacity: 0 }, end);
199
200 // 3-state karaoke via className SETS — seek-safe (gsap.set applies on the
201 // engine's frame-by-frame seek; .call callbacks would NOT fire).
202 words. forEach ( function ( w , i ) {
203 var el = document. getElementById ( "caption-word-" + g + "-" + i);
204 var at = Math. max (start, Number (w.start));
205 tl. set (el, { className: "caption-word" }, start); // upcoming (also resets on reverse-seek)
206 tl. set (el, { className: "caption-word is-active" }, at); // current
207 tl. fromTo (el, { scale: 0.98 }, { scale: 1 , duration: 0.16 , ease: "power1.out" }, at);
208 if (i + 1 < words. length ) {
209 var nextAt = Math. max (start, Number (words[i + 1 ].start));
210 tl. set (el, { className: "caption-word is-spoken" }, nextAt); // demote when next activates
211 }
212 });
213 if (words. length ) {
214 var lastEl = document. getElementById ( "caption-word-" + g + "-" + (words. length - 1 ));
215 var lastSpoken = Math. min (end, Number (words[words. length - 1 ].end) + 0.1 );
216 tl. set (lastEl, { className: "caption-word is-spoken" }, lastSpoken);
217 }
218 });
219
220 // full-span anchor so the sub-comp timeline spans the whole video
221 tl. to ({}, { duration: DURATION }, 0 );
222 window.__timelines[ "captions" ] = tl;
223 })();
224 </ script >