프레임워크 어댑터

React, Vue, Angular, Svelte 및 SolidJS에서 Sixtyfold 선형 및 주식 차트 사용.

Sixtyfold의 프레임워크 패키지는 동일한 LineChart 및 StockChart 엔진 주위에 얇은 라이프사이클 어댑터를 제공합니다. 이들은 렌더링 로직을 중복하지 않으며, 데이터를 재구성하지 않고, 런타임 텔레메트리를 추가하지 않으며, 모든 차트를 애플리케이션으로 끌어오지 않습니다.

사용하는 엔진과 함께 어댑터 하나를 설치하십시오. /line 또는 /stock 진입점만 가져오십시오:

pnpm add @sixtyfold/react@1 @sixtyfold/line@1
import { SixtyfoldLineChart } from "@sixtyfold/react/line";

react를 vue, angular, svelte 또는 solid로 교체하십시오. 스톡 차트의 경우 @sixtyfold/stock를 설치하고 /stock를 임포트하십시오. 차트 엔진은 어댑터의 선택적 피어 종속이므로 라인 차트를 설치해도 스톡은 설치되지 않습니다.

공유된 어댑터 계약

모든 어댑터는 컴포넌트가 마운트된 후 차트를 생성하고 initialize()를 기다린 다음 반응형 입력을 적용하며 언마운트 시 destroy()를 호출합니다. 이 과정은 또한 차트 Worker를 종료하고 옵서버, 리스너 및 대형 버퍼 참조를 해제합니다. SSR 중에는 컴포넌트가 캔버스 호스트만 내보내므로, 서버가 차트 픽셀을 그려야 하는 경우 @sixtyfold/ssr를 사용하십시오.

프롭/입력라인 유형스톡 유형동작
optionsLineChartOptionsStockChartOptions구성 시점 스냅샷입니다. 어댑터를 교체하려면 다시 마운트하십시오; 실시간 시각적 변경에는 appearance 을(를) 사용하십시오.
dataTimeSeriesData | MultiSeriesDataOHLCVData일회성 전송 가능한 대용량 데이터이며, 객체 식별자 기반으로 반응합니다. 항상 새로운 객체로 새 버퍼를 할당하십시오.
dataUpdateOptionsLineDataUpdateOptions—preservePreviousFrame 를(을) 포함한 애니메이션 라인 데이터 교체를 위한 반응형 설정; 이것만 변경해서는 설치된 데이터를 재전송하지 않습니다.
appearanceDeepPartial<LineAppearanceOptions>DeepPartial<StockAppearanceOptions>차트나 데이터를 재생성하거나 교체하지 않고 적용되는 심층 시각 패치입니다.
viewportPartial<Viewport>Partial<Viewport>반응형 X 범위입니다. 차트의 X 단위에 xMin, xMax 또는 둘 다를 제공하십시오.
viewportAnimatedbooleanboolean해당 뷰포트 업데이트에 대한 애니메이션을 재정의합니다. 차트 옵션을 상속하려면 정의하지 않으십시오.
statsIntervalMsnumbernumber최소 텔레메트리 콜백 간격(밀리초); 리스너가 없으면 텔레메트리는 활성화되지 않습니다.
readiness callback/eventLineChartStockChart초기화 및 첫 번째 성공적인 데이터, 외관, 뷰포트 속성 배치 후 차트 인스턴스당 한 번 발생합니다; 페인팅된 프레임을 기다리지 않습니다.
error callback/eventunknownunknown구성 및 반응형 prop-설치 오류, 렌더러 초기화/런타임 실패, 오버레이 해상도 또는 전달 실패를 보고합니다.
stats callback/eventLineChartStatsStockChartStatsstatsIntervalMs에서 렌더러 및 데이터 텔레메트리를 보고합니다.
series-visibility callback/eventSeriesVisibilityChangeEvent—초기화, API 호출 및 인터랙티브 범례에서의 표시 변경을 보고합니다.

모든 어댑터는 준비 상태, 구성 및 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 경계에 의해 숨겨진 차트도 포함됩니다.

React 전용 서피스유형설명
refRef<LineChartHandle | StockChartHandle>전달된(handle) 핸들로서 chart 필드에는 마운트된 명령형 인스턴스 또는 null 가 포함됩니다.
네이티브 캔버스 속성CanvasHTMLAttributes<HTMLCanvasElement>children를 제외하고 캔버스로 전달됩니다. aria-label, 클래스명, 인라인 스타일, 테스트 및 포인터 메타데이터에 사용하십시오.
onReady(chart) => void초기화 및 첫 성공적인 반응형(prop) 배치 이후 한 번 호출됩니다.
onError(error: unknown) => void생성, 반응형 prop 설치, 렌더러 초기화/런타임, 또는 오버레이 해결/전달 실패 시 호출됩니다.
onStats(stats) => void렌더러 텔레메트리를 활성화하고 수신합니다.
onSeriesVisibilityChange(event) => void선 전용 시리즈 표시 콜백.

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 리스너는 해당 구성 요소의 수명 동안 소비된 상태로 남습니다.

Vue 표면유형설명
공유 props프레임워크 prop 색인 참조Vue props는 공유 계약과 동일한 이름 및 타입을 사용합니다.
ready 이벤트LineChart | StockChart초기화 및 첫 번째 성공적인 반응형 prop 배치 이후 차트를 발생시킵니다.
error 이벤트unknown생성, 반응형 prop 설정, 렌더러 초기화/런타임 또는 오버레이 해결/전달 실패를 발생시킵니다.
stats 이벤트LineChartStats | StockChartStats텔레메트리를 활성화하고 전송합니다.
seriesVisibilityChange 이벤트SeriesVisibilityChangeEvent선 전용 가시성 이벤트입니다.
상속된 속성네이티브 Canvas 속성aria-label, class, style 같은 인식되지 않는 속성은 Canvas로 전달됩니다.
템플릿 ref chartShallowRef<LineChart | StockChart | null>마운트된 명령형 차트를 깊이 있는 프록시 없이 노출합니다.

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은 브라우저 전역 객체를 건드리지 않습니다.

Angular 입력유형설명
optionsLineChartOptions | StockChartOptions구성 시점 스냅샷.
dataLineData | OHLCVData일회 전달 가능한 반응형 데이터셋.
dataUpdateOptionsLineDataUpdateOptions선형 전용 교체 애니메이션 옵션.
appearanceDeepPartial<LineAppearanceOptions | StockAppearanceOptions>반응형 시각 패치.
viewportPartial<Viewport>반응형 X-도메인 패치.
viewportAnimatedboolean | undefined뷰포트 입력에 대한 애니메이션 재정의.
statsIntervalMsnumber | undefinedstats에 구독자가 있는 경우 최소 텔레메트리 간격.
canvasClassstring내부 캔버스에 적용되는 클래스.
ariaLabelstring접근성 용도의 캔버스 이름.
ariaDescribedBystring차트를 설명하는 인접한 텍스트 또는 표 대안의 ID입니다.
canvasRolestring명시적 캔버스 역할; 일반적으로 차트가 application 또는 img 를 선택하도록 둡니다.
canvasTabIndexnumber명시적 탭 순서; 보기 전용 차트는 기본적으로 생략됩니다.
canvasAttributesRecord<string, string | number | boolean | null | undefined>테스트 훅 및 메타데이터와 같은 추가 캔버스 속성입니다. 클래스, 스타일, 크기, 역할, 탭 순서 및 포커스된 접근성 입력은 별도로 관리됩니다.
Angular 출력페이로드설명
chartReadyLineChart | StockChart초기화 및 첫 번째 성공적인 반응형 프로퍼티 배치 이후 차트를 방출합니다.
chartErrorunknown생성, 반응형 프로퍼티 설치, 렌더러 초기화/런타임, 또는 오버레이 해결/전달 실패를 방출합니다.
statsLineChartStats | StockChartStats렌더러 텔레메트리를 활성화하고 방출합니다.
seriesVisibilityChangeSeriesVisibilityChangeEvent선만 보이는 가시성 출력.
public chartLineChart | StockChart | null컴포넌트 참조에 노출된 명령형 인스턴스.

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도 있습니다.

Svelte prop/binding유형설명
공통 props프레임워크 prop 색인을 참조하십시오공용 options, data, appearance, 뷰포트, 원격 텔레메트리 및 콜백 props를 사용합니다.
onReady(chart) => void초기화 및 첫 번째 성공적 반응형 prop 배치 이후 차트를 수신합니다.
onError(error: unknown) => void생성, 반응형 prop 설정, 렌더러 초기화/런타임 또는 오버레이 해결/전달 실패를 보고합니다.
onStats(stats) => void원격 분석을 활성화하고 수신합니다.
onSeriesVisibilityChange(event) => void선 전용 가시성 콜백입니다.
canvasClassstring캔버스에 적용되는 클래스입니다.
canvasStylestring캔버스에 적용되는 CSS 선언 텍스트입니다.
ariaLabelstring접근 가능한 캔버스 이름.
바인더블 chartLineChart | StockChart | null마운트된 명령형 차트; 정리 시 null로 재설정됩니다.

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는 공유 계약을 따릅니다.

SolidJS 전용 표면유형설명
chartRef(chart | null) => void마운트된 명령형 차트를 수신하고 정리 시점에 null 합니다.
canvasPropsJSX.CanvasHTMLAttributes<HTMLCanvasElement>네이티브 캔버스 속성, 접근성 메타데이터, 클래스, 스타일 및 테스트 훅.
onReady(chart) => void초기화 후 및 첫 번째 성공적인 반응형 prop 배치 이후에 호출됩니다.
onError(error: unknown) => void생성, 반응형 prop 설치, 렌더러 초기화/런타임 또는 오버레이 해결/전달 실패 시 호출됩니다.
onStats(stats) => void원격 텔레메트리 수집을 활성화하고 수신합니다.
onSeriesVisibilityChange(event) => void선 전용 가시성 콜백입니다.

완전한 예제

공개 리포지토리에는 지원되는 각 프레임워크용 최소한의 반응형 애플리케이션이 포함되어 있습니다. 각 애플리케이션은 패키지, 데이터 형식, 차트 설정 및 정리(cleanup)를 표시하여 선형 차트와 주식 차트 둘 다를 재현하는 데 필요한 내용을 보여줍니다.