Files
hyperframes/docs/catalog/blocks/transitions-cover.mdx
miga-heygenandMiguel Ángel 7b5fdb1ad2 fix(docs): emit catalog source accordion titles as plain strings (#4006)
The generated catalog pages rendered the "Source" accordion title as a
JSX expression, `<Accordion title={`name.html`}>`. Mintlify's search
indexer stringifies expression attribute nodes rather than evaluating
them, so every one of the 399 catalog pages surfaced its Source section
in search results as "[object Object]" (visible on the Scroll Feed page,
among others).

The template literal carried no escaping benefit: every title is a
single-segment `name.html` path, and a double-quoted JSX string handles
it directly. Introduce `mdxStringAttribute`, which emits a plain
`name="value"` attribute and escapes `& " < { }` as HTML character
references (MDX decodes references inside quoted attribute values, and
unlike JSON.stringify it does not rely on backslash escapes, which JSX
strings do not honour). Use it for both the Source accordion title and
the preview iframe title, and regenerate the catalog pages.

Regenerated with `npx tsx scripts/generate-catalog-pages.ts`; the only
change across the 399 pages is the one Accordion title line each.

Co-authored-by: Miguel Ángel <miguel.sierra@heygen.com>
2026-09-16 11:55:00 -04:00

432 lines
13 KiB
Plaintext

---
title: "Cover Transitions"
description: "Showcase of cover/uncover slide transitions"
---
import { InstallCommand } from "/snippets/install-command.jsx";
## Install
<InstallCommand command="npx hyperframes add transitions-cover" item="transitions-cover" />
That writes one file: `compositions/transitions-cover.html`.
<iframe
className="w-full aspect-video rounded-xl border-0 bg-zinc-100 dark:bg-zinc-800"
title="transitions-cover preview"
loading="lazy"
srcDoc={`<!doctype html><html><head><meta charset="utf-8"><style>html,body{margin:0;height:100%;overflow:hidden;background:transparent}hyperframes-player{display:block;width:100%;height:100%}</style><script src="https://cdn.jsdelivr.net/npm/@hyperframes/player@latest/dist/hyperframes-player.global.js"><\/script></head><body><script>fetch("/public/catalog/blocks/transitions-cover.json").then(function(r){return r.json()}).then(function(d){var p=document.createElement("hyperframes-player");p.setAttribute("srcdoc",d.html);p.setAttribute("controls","");p.setAttribute("autoplay","");p.setAttribute("loop","");p.setAttribute("muted","");p.setAttribute("poster","https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/transitions-cover.png");document.body.appendChild(p)});<\/script></body></html>`}
/>
## Source
<Accordion title="transitions-cover.html">
```html
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Cover Transitions Showcase</title>
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
<style>
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
body {
background: #000;
overflow: hidden;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
}
/* Title Card */
#title-card {
position: absolute;
inset: 0;
z-index: 10;
background: linear-gradient(135deg, #0d1b2a 0%, #1b263b 100%);
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
opacity: 1;
}
#title-card h1 {
font-size: 72px;
font-weight: 800;
color: #fff;
letter-spacing: -1px;
opacity: 0;
transform: translateY(30px);
}
#title-card .subtitle {
font-size: 28px;
font-weight: 400;
color: rgba(255, 255, 255, 0.5);
margin-top: 12px;
opacity: 0;
transform: translateY(20px);
}
/* Scenes */
#scene1,
#scene2 {
position: absolute;
inset: 0;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
}
#scene1 {
background: #1b263b;
z-index: 2;
opacity: 0;
}
#scene2 {
background: #e07a5f;
z-index: 1;
opacity: 0;
}
.scene-number {
font-size: 180px;
font-weight: 900;
line-height: 1;
opacity: 0.12;
letter-spacing: -6px;
}
#scene1 .scene-number {
color: #fff;
}
#scene2 .scene-number {
color: #000;
}
.scene-label {
font-size: 48px;
font-weight: 700;
margin-top: -20px;
}
#scene1 .scene-label {
color: #fff;
}
#scene2 .scene-label {
color: #fff;
}
/* Info bar */
.info-bar {
position: absolute;
bottom: 0;
left: 0;
right: 0;
height: 80px;
display: flex;
align-items: center;
justify-content: space-between;
padding: 0 48px;
}
#scene1 .info-bar {
background: rgba(0, 0, 0, 0.3);
}
#scene2 .info-bar {
background: rgba(0, 0, 0, 0.2);
}
.info-bar .label {
font-size: 18px;
font-weight: 600;
color: rgba(255, 255, 255, 0.7);
text-transform: uppercase;
letter-spacing: 2px;
}
.info-bar .desc {
font-size: 16px;
color: rgba(255, 255, 255, 0.5);
font-style: italic;
}
/* Outro */
#outro {
position: absolute;
inset: 0;
z-index: 10;
background: linear-gradient(135deg, #0d1b2a 0%, #1b263b 100%);
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
opacity: 0;
}
#outro h2 {
font-size: 56px;
font-weight: 800;
color: #fff;
opacity: 0;
transform: translateY(20px);
}
#outro .tag {
font-size: 22px;
color: rgba(255, 255, 255, 0.4);
margin-top: 10px;
opacity: 0;
transform: translateY(15px);
}
</style>
</head>
<body>
<div
id="comp"
data-composition-id="main"
data-start="0"
data-duration="21"
data-width="1920"
data-height="1080"
style="position: relative; width: 1920px; height: 1080px; overflow: hidden; background: #000"
>
<!-- Title Card -->
<div id="title-card">
<h1 id="title-h1">Cover Transitions</h1>
<div class="subtitle" id="title-sub">3 transition styles</div>
</div>
<!-- Scene A -->
<div id="scene1">
<div class="scene-number">ONE</div>
<div class="scene-label">SCENE A</div>
<div class="info-bar">
<span class="label" id="info-label-a"></span>
<span class="desc" id="info-desc-a"></span>
</div>
</div>
<!-- Scene B -->
<div id="scene2">
<div class="scene-number">TWO</div>
<div class="scene-label">SCENE B</div>
<div class="info-bar">
<span class="label" id="info-label-b"></span>
<span class="desc" id="info-desc-b"></span>
</div>
</div>
<!-- Staggered Blocks Wipes -->
<div
id="wipe-a"
style="
position: absolute;
inset: 0;
background: #f72585;
z-index: 50;
transform: translateX(-1920px);
"
></div>
<div
id="wipe-b"
style="
position: absolute;
inset: 0;
background: #7209b7;
z-index: 49;
transform: translateX(-1920px);
"
></div>
<!-- Horizontal Blinds Container -->
<div
id="blinds-container"
style="position: absolute; inset: 0; z-index: 50; pointer-events: none"
></div>
<!-- Vertical Blinds Container -->
<div
id="vblinds-container"
style="position: absolute; inset: 0; z-index: 50; pointer-events: none"
></div>
<!-- Outro -->
<div id="outro">
<h2 id="outro-h2">Cover Transitions</h2>
<div class="tag" id="outro-tag">End of showcase</div>
</div>
</div>
<script>
(function () {
// Generate horizontal blind strips
var blindsHTML = "";
for (var i = 0; i < 8; i++) {
blindsHTML +=
'<div id="blind-' +
i +
'" style="position:absolute; left:0; width:1920px; height:135px; top:' +
i * 135 +
"px; background:" +
[
"#3A0CA3",
"#4361EE",
"#4CC9F0",
"#F72585",
"#3A0CA3",
"#4361EE",
"#4CC9F0",
"#F72585",
][i] +
'; transform:translateX(-1920px);"></div>';
}
document.getElementById("blinds-container").innerHTML = blindsHTML;
// Generate vertical blind strips
var vblindsHTML = "";
for (var i = 0; i < 8; i++) {
vblindsHTML +=
'<div id="vblind-' +
i +
'" style="position:absolute; top:0; height:1080px; width:240px; left:' +
i * 240 +
"px; background:" +
[
"#3A0CA3",
"#4361EE",
"#4CC9F0",
"#F72585",
"#3A0CA3",
"#4361EE",
"#4CC9F0",
"#F72585",
][i] +
'; transform:translateY(-1080px);"></div>';
}
document.getElementById("vblinds-container").innerHTML = vblindsHTML;
var tl = gsap.timeline({ paused: false });
window.__timelines = window.__timelines || {};
window.__timelines["main"] = tl;
// Transition demos config
var demos = [
{ label: "STAGGERED BLOCKS", desc: "Use a staggered color blocks transition" },
{ label: "HORIZONTAL BLINDS", desc: "Use a horizontal blinds transition" },
{ label: "VERTICAL BLINDS", desc: "Use a vertical blinds transition" },
];
// Reset scenes helper
function resetScenes(t, demoIndex) {
tl.set("#scene1", { opacity: 1 }, t);
tl.set("#scene2", { opacity: 0 }, t);
tl.set("#info-label-a", { textContent: demos[demoIndex].label }, t);
tl.set("#info-desc-a", { textContent: demos[demoIndex].desc }, t);
tl.set("#info-label-b", { textContent: demos[demoIndex].label }, t);
tl.set("#info-desc-b", { textContent: demos[demoIndex].desc }, t);
// Reset wipes
tl.set("#wipe-a", { x: -1920 }, t);
tl.set("#wipe-b", { x: -1920 }, t);
// Reset horizontal blinds
for (var i = 0; i < 8; i++) {
tl.set("#blind-" + i, { x: -1920 }, t);
}
// Reset vertical blinds
for (var i = 0; i < 8; i++) {
tl.set("#vblind-" + i, { y: -1080 }, t);
}
}
// ===== TITLE CARD (0s - 3s) =====
tl.to("#title-h1", { opacity: 1, y: 0, duration: 0.6, ease: "power2.out" }, 0.3);
tl.to("#title-sub", { opacity: 1, y: 0, duration: 0.5, ease: "power2.out" }, 0.6);
tl.to("#title-card", { opacity: 0, duration: 0.4, ease: "power1.inOut" }, 2.5);
// ===== DEMO 1: STAGGERED BLOCKS (3s - 8s) =====
var T1 = 3;
resetScenes(T1, 0);
// Show Scene A for a beat, then transition at midpoint
var T = T1 + 2;
tl.set("#wipe-a", { x: -1920 }, T - 0.01);
tl.set("#wipe-b", { x: -1920 }, T - 0.01);
tl.to("#wipe-a", { x: 0, duration: 0.25, ease: "power3.inOut" }, T);
tl.to("#wipe-b", { x: 0, duration: 0.25, ease: "power3.inOut" }, T + 0.06);
tl.set("#scene1", { opacity: 0 }, T + 0.2);
tl.set("#scene2", { opacity: 1 }, T + 0.2);
tl.to("#wipe-a", { x: 1920, duration: 0.25, ease: "power3.inOut" }, T + 0.28);
tl.to("#wipe-b", { x: 1920, duration: 0.25, ease: "power3.inOut" }, T + 0.34);
// ===== DEMO 2: HORIZONTAL BLINDS (8s - 13s) =====
var T2 = 8;
resetScenes(T2, 1);
T = T2 + 2;
var stagger = 0.03;
for (var i = 0; i < 8; i++) {
tl.fromTo(
"#blind-" + i,
{ x: -1920 },
{ x: 0, duration: 0.2, ease: "power3.inOut" },
T + i * stagger,
);
}
tl.set("#scene1", { opacity: 0 }, T + 0.5);
tl.set("#scene2", { opacity: 1 }, T + 0.5);
for (var i = 0; i < 8; i++) {
tl.to(
"#blind-" + i,
{ x: 1920, duration: 0.2, ease: "power3.inOut" },
T + 0.55 + i * stagger,
);
}
// ===== DEMO 3: VERTICAL BLINDS (13s - 18s) =====
var T3 = 13;
resetScenes(T3, 2);
T = T3 + 2;
for (var i = 0; i < 8; i++) {
tl.fromTo(
"#vblind-" + i,
{ y: -1080 },
{ y: 0, duration: 0.2, ease: "power3.inOut" },
T + i * 0.03,
);
}
tl.set("#scene1", { opacity: 0 }, T + 0.5);
tl.set("#scene2", { opacity: 1 }, T + 0.5);
for (var i = 0; i < 8; i++) {
tl.to(
"#vblind-" + i,
{ y: 1080, duration: 0.2, ease: "power3.inOut" },
T + 0.55 + i * 0.03,
);
}
// ===== OUTRO (18s - 21s) =====
tl.to("#scene1", { opacity: 0, duration: 0.3 }, 18);
tl.to("#scene2", { opacity: 0, duration: 0.3 }, 18);
tl.to("#outro", { opacity: 1, duration: 0.4, ease: "power1.inOut" }, 18.2);
tl.to("#outro-h2", { opacity: 1, y: 0, duration: 0.5, ease: "power2.out" }, 18.5);
tl.to("#outro-tag", { opacity: 1, y: 0, duration: 0.4, ease: "power2.out" }, 18.8);
})();
</script>
</body>
</html>
```
</Accordion>
## Usage
After installing, add the block to your host composition:
```html
<div data-composition-id="transitions-cover" data-composition-src="compositions/transitions-cover.html" data-start="0" data-duration="21" data-track-index="1" data-width="1920" data-height="1080"></div>
```
{/* hf:generated-footer */}
Tagged `transition` `showcase`.
## Related topics
- [Browse the complete Catalog](/catalog)
- [Add assets and Catalog items in Studio](/studio/assets-and-blocks)
- [Build a richer composition](/go-further)