서버 사이드 렌더링
DOM에 의존하지 않는 Canvas2D 계약을 통해 선형 및 스톡 차트를 렌더링합니다.
@sixtyfold/ssr는 최소한의 서버 캔버스에서 동일한 TypeScript 렌더러를 실행합니다. 이는 DOM 캔버스 전역을 가져오거나 브라우저 Worker를 생성하거나 애니메이션을 수행하지 않습니다. 실제 선형 및 스톡 PNG 출력은 Node.js, Bun 및 Deno에서 지속적으로 검증됩니다.
SSR 패키지와 실행 환경에 적합한 Canvas2D 구현을 설치하십시오. 검증된 호환성 세트는 @napi-rs/canvas를 사용하지만, Sixtyfold는 이를 라이브러리 종속성으로 강제하지 않습니다.
생성된 참조에는 정확한 SSR 함수들, 렌더 옵션들, 및 런타임 중립 캔버스 타입들이 나열되어 있습니다.
pnpm add @sixtyfold/ssr@1 @napi-rs/canvasimport { createCanvas } from "@napi-rs/canvas";
import { renderLineChartSSR } from "@sixtyfold/ssr";
const width = 1200;
const height = 630;
const canvas = createCanvas(width * 2, height * 2);
renderLineChartSSR(
canvas,
data,
{
animated: false,
chartBackground: "#081018",
series: [{ color: "#65d6ff", width: 2 }],
axis: { bottom: { format: "time" } },
},
{ width, height, dpr: 2 },
);
const png = await canvas.encode("png");캔버스 구현체가 이미지 인코딩을 담당합니다.
검증된 서버 런타임
호환성 스위트는 현재 다음 CI 대상들을 고정하고 있습니다:
이들은 재현 가능한 CI 대상이며 최소 버전 보장은 아닙니다. 각 런타임은 네트워크 접근 없이 결정론적 Line 및 Stock 픽스처를 렌더링합니다. 게이트는 플롯 픽셀을 고정된 시각적 참조와 비교하고, 모든 명명된 레이블이 유한한 영역 내의 정확한 레이아웃 앵커 위치에서 가시 잉크를 생성하는지를 요구합니다; 또한 PNG 서명, 치수 및 인코딩된 출력도 검증합니다. 글꼴에 따른 글리프 폭이나 잉크 비율은 고정하지 않습니다. PNG는 검토 가능한 CI 아티팩트로 보관됩니다. 릴리스 전에는 Node 시각적 참조가 Ubuntu, macOS, 및 Windows에서 반복됩니다.
Node.js 및 Bun은 동일한 모듈을 직접 실행합니다:
node app.mjs
bun app.mjsDeno는 로컬 node_modules 트리와 Node-API 캔버스 애드온에 대한 명시적 권한을 요구합니다:
deno run \
--allow-read \
--allow-env \
--allow-ffi \
--allow-sys=homedir \
--node-modules-dir=manual \
app.mjs애플리케이션이 인코딩된 이미지를 디스크에 쓸 때에만 --allow-write=<output-directory>을 추가하십시오. 런타임 검증 소스, Bun Node-API 지원, 및 Deno 네이티브 애드온 지침을 참조하십시오.
지원되는 구성
SSR은 렌더러 대상 시각 옵션을 허용합니다: 패딩, 방향, 그리드, 축, 배경, 범위 선택기, 툴팁 스타일, 크로스헤어 스타일, 레이블, 오버레이, 선 시리즈/상세도(LOD), 스톡 캔들, 지표, 거래량 프로필, 가격선 및 마커. 브라우저 전용 콜백, DOM 제어, 포인터 상호작용 및 Worker는 의도적으로 제외되어 있습니다.
1.0.1 헬퍼는 차트 수준 선 marker 스타일링과 스톡 timeScale, showLeftPriceMarker, showRightPriceMarker 옵션을 공유 렌더러로 전달합니다. 정적 스톡 출력의 결측 관측값 압축에는 timeScale: "market"를 사용하십시오. 명시적 axis.left.cursorLabel.visible 또는 axis.right.cursorLabel.visible 설정은 일치하는 가격 마커 별칭보다 우선합니다. 정적 출력은 호버 이벤트나 커서 이동을 생성하지 않습니다.
정적 렌더링은 즉시 완료되지만 명확성을 위해 animated: false을 설정하십시오. 스냅샷 차이를 방지하려면 테스트와 프로덕션에서 동일한 width, height 및 dpr 계약을 사용하십시오.
런타임-중립 캔버스 주입
호출자가 캔버스를 아직 소유하지 않은 경우 createCanvas 을 SSRRenderOptions 에 제공하십시오. 이 객체는 백킹 스토어 크기를 받습니다. 반환된 객체에는 렌더러가 사용하는 Canvas2D 메서드와 함께 width, height, getContext("2d") 가 필요합니다.
결정적 출력
- 렌더링 이미지에 캔버스 구현체와 글꼴을 고정하십시오.
- 서버가 브라우저 스택을 제공하지 않는 경우 명시적인 글꼴 패밀리를 전달하십시오.
- 요청 렌더링 중 원격 URL 오버레이를 피하십시오; 렌더링 전에 자산을 해결하고 캐시하십시오.
- 입력 배열, 차트 크기, DPR, 로케일, 표준시대(타임존) 및 옵션을 안정적으로 유지하십시오.