HyperFrames 레지스트리
레지스트리는 hyperframes add <name> 명령으로 설치 가능한 재사용 가능한 블록과 컴포넌트를 제공합니다.
- 블록 — 독립적인 서브-컴포지션 (자체적인 크기, 지속 시간, 타임라인 보유). 호스트 컴포지션에서
data-composition-src를 통해 포함됩니다. - 컴포넌트 — 이펙트 스니펫 (자체 크기 없음). 호스트 컴포지션의 HTML에 직접 붙여넣어집니다.
이 스킬을 사용해야 하는 경우
- 사용자가
hyperframes add, "블록", "컴포넌트", 또는hyperframes.json을 언급하는 경우 hyperframes add의 출력(파일 경로, 클립보드 스니펫)이 세션에 나타나는 경우- 설치된 항목을 기존 컴포지션에 와이어링해야 하는 경우
- 레지스트리에서 사용 가능한 항목을 검색하려는 경우
빠른 참조
hyperframes add data-chart # 블록 설치
hyperframes add grain-overlay # 컴포넌트 설치
hyperframes add shimmer-sweep --dir . # 특정 프로젝트 대상
hyperframes add data-chart --json # 기계 판독 가능 출력
hyperframes add data-chart --no-clipboard # 클립보드 건너뛰기 (CI/헤드리스)
설치 후, CLI는 작성된 파일 목록과 호스트 컴포지션에 붙여넣을 스니펫을 출력합니다. 이 스니펫은 시작점일 뿐이며, 블록을 와이어링할 때 data-composition-id (블록의 내부 컴포지션 ID와 일치해야 함), data-start, data-track-index 속성을 직접 추가해야 합니다.
참고: hyperframes add는 블록과 컴포넌트에만 작동합니다. 예제의 경우 hyperframes init <dir> --example <name>을 대신 사용하세요.
설치 위치
블록은 기본적으로 compositions/<name>.html에 설치됩니다.
컴포넌트는 기본적으로 compositions/components/<name>.html에 설치됩니다.
이러한 경로는 hyperframes.json에서 설정할 수 있습니다:
{
"registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
"paths": {
"blocks": "compositions",
"components": "compositions/components",
"assets": "assets"
}
}
자세한 내용은 install-locations.md를 참조하세요.
블록 와이어링
블록은 독립적인 컴포지션입니다. 호스트 index.html에서 data-composition-src를 통해 포함합니다:
<div
data-composition-id="data-chart"
data-composition-src="compositions/data-chart.html"
data-start="2"
data-duration="15"
data-track-index="1"
data-width="1920"
data-height="1080"
></div>
주요 속성:
data-composition-src— 블록 HTML 파일 경로data-composition-id— 블록의 내부 ID와 일치해야 함data-start— 블록이 호스트 타임라인에 나타나는 시간 (초)data-duration— 블록이 재생되는 시간data-width/data-height— 블록 캔버스 크기data-track-index— 레이어 순서 (값이 클수록 앞쪽)
자세한 내용은 wiring-blocks.md를 참조하세요.
컴포넌트 와이어링
컴포넌트는 스니펫입니다. 해당 HTML을 컴포지션의 마크업에, CSS를 스타일 블록에, JS를 스크립트(있는 경우)에 붙여넣으세요:
- 설치된 파일을 읽습니다 (예:
compositions/components/grain-overlay.html) - HTML 요소를 컴포지션의
<div data-composition-id="...">에 복사합니다 <style>블록을 컴포지션의 스타일에 복사합니다<script>콘텐츠를 컴포지션의 스크립트(타임라인 코드 앞)에 복사합니다- 컴포넌트가 GSAP 타임라인 통합을 제공하는 경우 (스니펫의 주석 블록 참조), 해당 호출을 타임라인에 추가합니다
자세한 내용은 wiring-components.md를 참조하세요.
검색
사용 가능한 항목을 검색합니다:
# 레지스트리 매니페스트 읽기
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json
각 항목의 registry-item.json에는 이름, 유형, 제목, 설명, 태그, 크기(블록만 해당), 지속 시간(블록만 해당), 파일 목록이 포함됩니다.
유형과 태그별 필터링에 대한 자세한 내용은 discovery.md를 참조하세요.