프레임워크 어댑터
React, Vue, Angular, Svelte 및 SolidJS에서 Sixtyfold 선형 및 주식 차트 사용.
Sixtyfold의 프레임워크 패키지는 동일한 LineChart 및 StockChart 엔진 주위에 얇은 라이프사이클 어댑터를 제공합니다. 이들은 렌더링 로직을 중복하지 않으며, 데이터를 재구성하지 않고, 런타임 텔레메트리를 추가하지 않으며, 모든 차트를 애플리케이션으로 끌어오지 않습니다.
사용하는 엔진과 함께 어댑터 하나를 설치하십시오. /line 또는 /stock 진입점만 가져오십시오:
pnpm add @sixtyfold/react@1 @sixtyfold/line@1import { SixtyfoldLineChart } from "@sixtyfold/react/line";react를 vue, angular, svelte 또는 solid로 교체하십시오. 스톡 차트의 경우 @sixtyfold/stock를 설치하고 /stock를 임포트하십시오. 차트 엔진은 어댑터의 선택적 피어 종속이므로 라인 차트를 설치해도 스톡은 설치되지 않습니다.
공유된 어댑터 계약
모든 어댑터는 컴포넌트가 마운트된 후 차트를 생성하고 initialize()를 기다린 다음 반응형 입력을 적용하며 언마운트 시 destroy()를 호출합니다. 이 과정은 또한 차트 Worker를 종료하고 옵서버, 리스너 및 대형 버퍼 참조를 해제합니다. SSR 중에는 컴포넌트가 캔버스 호스트만 내보내므로, 서버가 차트 픽셀을 그려야 하는 경우 @sixtyfold/ssr를 사용하십시오.
모든 어댑터는 준비 상태, 구성 및 prop-설치 오류, 렌더러 및 오버레이 오류와 렌더 통계를 보고합니다. 라인 어댑터는 또한 SeriesVisibilityChangeEvent를 보고합니다. 각 프레임워크는 관례적인 ref 또는 컴포넌트 API를 통해 기본 LineChart 또는 StockChart 인스턴스를 노출하므로, 드문 명령형 작업도 여전히 사용할 수 있습니다.
준비 상태(Readiness)는 초기 props가 수용되었음을 의미하며, 첫 캔버스 프레임이 그려졌음을 의미하지 않습니다. ready 콜백에서 수행한 명령형 변경은 지연된 초기 prop 배치에 의해 덮어쓰여지지 않습니다.
차트 실패 처리
어댑터 오류 훅은 unknown을 허용합니다. JavaScript 구성 오류가 특정 클래스를 사용하도록 요구하지 않기 때문입니다. Sixtyfold 렌더러에서 방출된 실패는 ChartRendererError 인스턴스입니다. 오버레이 해결 또는 렌더러 전달 실패는 ChartOverlayError 인스턴스입니다. 구조화된 필드를 읽기 전에 값을 좁히십시오:
import {
ChartOverlayError,
ChartRendererError,
} from "@sixtyfold/line";
export function reportChartError(error: unknown) {
if (error instanceof ChartRendererError) {
console.error(error.phase, error.message);
return;
}
if (error instanceof ChartOverlayError) {
console.error("Overlay sources failed:", error.sources);
return;
}
console.error(error);
}스톡 전용 애플리케이션에서는 @sixtyfold/stock에서 동일한 import를 사용하십시오. error.phase은 "initialization" 또는 "runtime"입니다. 렌더러 실패는 해당 차트 인스턴스를 파괴하므로, 애플리케이션이 복구를 선택하면 어댑터를 다시 마운트해야 합니다. 오버레이 실패는 치명적이지 않습니다: 성공한 항목은 설치된 상태로 남고, 요청된 모든 항목이 실패하면 이전에 렌더된 오버레이가 유지됩니다.
거부된 반응형 prop 설치는 오류를 보고하고 초기 준비 알림을 보류합니다. 수정된 props를 제공하면 재마운트 없이 재시도할 수 있습니다. 이후의 prop이 실패할 때 이미 성공적으로 설치된 데이터는 다시 전송되지 않습니다. 이 복구는 터미널 렌더러 오류에는 적용되지 않습니다.
대량 타입화 배열은 Worker로 전송됩니다. 각 데이터 객체를 일회성으로 취급하십시오: 제자리에서 변경하지 말고, 각 업데이트마다 새 버퍼를 가진 새 객체를 할당하십시오. 이렇게 하면 수백만 포인트 데이터셋에 대한 제로-카피 경로가 유지됩니다.
React
import { useMemo, useRef } from "react";
import {
SixtyfoldLineChart,
type LineChartHandle,
} from "@sixtyfold/react/line";
export function Signals() {
const chartRef = useRef<LineChartHandle>(null);
const data = useMemo(() => ({
x: new Float64Array([0, 1, 2, 3]),
y: new Float64Array([3, 7, 4, 9]),
length: 4,
}), []);
return (
<SixtyfoldLineChart
ref={chartRef}
data={data}
aria-label="Signal history"
onError={console.error}
/>
);
}컴포넌트는 일반적인 canvas 속성을 허용합니다. 해당 ref는 ref.current?.chart를 노출합니다. 초기 구성은 마이크로태스크로 지연되어 React Strict Mode의 개발 수명주기 프로브가 초기 데이터를 두 번 전송할 수 없습니다.
React 19.2+ Activity 은(는) 렌더러를 재생성하거나 데이터를 재전송하지 않고 차트를 숨기거나 표시할 수 있습니다. 프로퍼티 설정과 준비/오류 알림은 표시될 때까지 대기하며 통계 및 시리즈 가시성 콜백은 숨겨진 동안 연결이 해제됩니다. 보유된 Worker와 버퍼는 실제로 컴포넌트가 언마운트될 때(숨겨진 상태에서의 언마운트를 포함하여) 해제됩니다.
React는 숨겨진 동안 전달된 ref를 분리합니다. 이전에 캡처된 핸들도 다시 표시될 때까지 .chart에서 null을 반환합니다. React 18과 React 19.2 이전의 React 19 릴리스는 패시브 정리(passive cleanup)를 통해 언마운트 시 차트를 파괴하며, 여기에는 다시 일시 중단된 Suspense 경계에 의해 숨겨진 차트도 포함됩니다.
Vue
<script setup lang="ts">
import { shallowRef } from "vue";
import { SixtyfoldLineChart } from "@sixtyfold/vue/line";
const data = shallowRef({
x: new Float64Array([0, 1, 2, 3]),
y: new Float64Array([3, 7, 4, 9]),
length: 4,
});
</script>
<template>
<SixtyfoldLineChart
:data="data"
aria-label="Signal history"
@error="console.error"
/>
</template>대량 데이터에는 Vue의 딥 프록시 대신 shallowRef 또는 markRaw을 사용하십시오. 구성 요소는 ready, error 및 stats를 방출하며; 선형 차트는 또한 seriesVisibilityChange를 방출합니다. 템플릿 ref는 그 얕은 chart ref를 노출합니다.
통계 수집은 반응형 리스너를 따릅니다. 단일 @stats.once 리스너는 첫 이벤트 후 수집을 비활성화하고; 일반 @stats 리스너는 활성 상태를 유지합니다. 소비된 .once 리스너는 해당 구성 요소의 수명 동안 소비된 상태로 남습니다.
Angular
Angular 20–22 패키지는 스탠드얼론 컴포넌트와 Angular Package Format 보조 진입점을 사용합니다.
import { Component } from "@angular/core";
import { SixtyfoldLineChartComponent } from "@sixtyfold/angular/line";
@Component({
standalone: true,
imports: [SixtyfoldLineChartComponent],
template: `
<sixtyfold-line-chart
[data]="data"
ariaLabel="Signal history"
(chartError)="reportError($event)"
/>
`,
})
export class Signals {
data = {
x: new Float64Array([0, 1, 2, 3]),
y: new Float64Array([3, 7, 4, 9]),
length: 4,
};
reportError(error: unknown) {
console.error(error);
}
}입력은 공통 표와 접근성 집중 필드 및 canvasAttributes를 따릅니다. 출력은 chartReady, chartError, stats이며, 선 컴포넌트는 또한 seriesVisibilityChange를 방출합니다. 컴포넌트 참조는 공개 chart를 노출합니다.
통계 수집은 활성 구독자가 stats 출력을 받을 수 있는 동안에만 활성화됩니다. 마지막 구독자가 구독 취소할 때(take(1) 포함)와 출력이 완료되거나 오류가 발생하거나 닫힐 때 수집은 중단됩니다.
Angular의 애플리케이션 빌더는 패키지 소유 Vite Worker URL을 변환하지 않습니다. 애플리케이션에서 사용하는 엔진을 빌드 타겟의 assets 배열에 angular.json에 추가하십시오:
[
{ "glob": "**/*", "input": "node_modules/@sixtyfold/line/dist/assets", "output": "assets" },
{ "glob": "**/*", "input": "node_modules/@sixtyfold/stock/dist/assets", "output": "assets" }
]차트 생성은 isPlatformBrowser로 보호되므로 Angular SSR은 브라우저 전역 객체를 건드리지 않습니다.
Svelte
<script lang="ts">
import LineChart from "@sixtyfold/svelte/line";
const data = {
x: new Float64Array([0, 1, 2, 3]),
y: new Float64Array([3, 7, 4, 9]),
length: 4,
};
</script>
<LineChart
{data}
ariaLabel="Signal history"
onError={console.error}
/>chart는 명령형 접근을 위해 바인딩할 수 있습니다. 추가 Svelte 속성으로 선형 차트에는 onReady, onError, onStats, onSeriesVisibilityChange가 있으며 canvasClass, canvasStyle, ariaLabel도 있습니다.
SolidJS
import { SixtyfoldLineChart } from "@sixtyfold/solid/line";
const data = {
x: new Float64Array([0, 1, 2, 3]),
y: new Float64Array([3, 7, 4, 9]),
length: 4,
};
export function Signals() {
return (
<SixtyfoldLineChart
data={data}
canvasProps={{ "aria-label": "Signal history" }}
chartRef={(chart) => console.log(chart)}
onError={console.error}
/>
);
}chartRef는 마운트된 차트를 수신하고 이후 정리 과정에서 null합니다. canvasProps는 네이티브 캔버스 속성을 전달합니다. 다른 모든 props는 공유 계약을 따릅니다.
완전한 예제
공개 리포지토리에는 지원되는 각 프레임워크용 최소한의 반응형 애플리케이션이 포함되어 있습니다. 각 애플리케이션은 패키지, 데이터 형식, 차트 설정 및 정리(cleanup)를 표시하여 선형 차트와 주식 차트 둘 다를 재현하는 데 필요한 내용을 보여줍니다.