Kumo Charts

플러그인으로 그리기

차트에 없는 것은 플러그인으로 캔버스에 직접 그릴 수 있습니다. 워터마크, 배경 색 영역, 직접 계산한 표시 같은 것입니다. 플러그인은 차트와 함께 다시 그려지므로 확대/축소하거나 드래그해도 위치가 어긋나지 않습니다.

코드 보기코드 숨기기
import { createChart, withAlpha, type ChartPlugin } from '@kumo-charts/core';
import { loadBars } from '@docs/data';

/** 메인 창 한가운데의 워터마크 */
function watermark(text: string): ChartPlugin {
  return {
    name: 'watermark',
    paint: ({ ctx, layer, pane, theme, font }) => {
      if (layer !== 'below' || pane.id !== 'main') return;
      ctx.font = `600 40px ${font.family}`;
      ctx.fillStyle = withAlpha(theme.text, 0.07);
      ctx.textAlign = 'center';
      ctx.textBaseline = 'middle';
      ctx.fillText(text, pane.width / 2, pane.height / 2);
    }
  };
}

const chart = createChart(document.getElementById('chart')!);
chart.plugins.add(watermark('BTCUSDT · 1h'));

chart.data.set(await loadBars(), { interval: '1m' });
chart.data.setTimeframe('1h');

그리는 방법

차트는 다시 그릴 때마다 창마다 paint를 두 번 호출합니다.

  • layer: 'below': 격자 다음, 봉 이전. 배경 같은 것을 그립니다.
  • layer: 'above': 봉 다음, 그리기와 주문선 이전. 표시 같은 것을 그립니다.

ctx는 이미 이 창의 플롯 영역으로 잘려 있고 좌표도 그 왼쪽 위로 옮겨져 있으므로 CSS 픽셀 단위로 그리면 됩니다. 고해상도 화면의 배율은 이미 처리되어 있습니다.

paint가 받는 컨텍스트에는 다음이 들어 있습니다.

필드 용도
pane 창의 id와 너비·높이, 가격과 픽셀을 변환하는 valueToY, yToValue, 축의 형식으로 가격을 표시하는 formatValue
bars 표시되는 봉, 열 단위로 읽음
visible 보이는 첫 봉과 마지막 봉의 인덱스, 봉이 없으면 null
indexToX, xToIndex, timeToX 인덱스·시간과 가로 좌표 사이의 변환
barSpacing 봉 하나가 차지하는 너비
theme, font 현재 테마와 글꼴, 색상은 테마를 따름
source, cutoff 원래 주기의 봉, 리플레이 중에는 cutoff 이후를 그리지 않아야 함

보이는 부분만 그리면 봉이 아무리 많아도 느려지지 않습니다.

import { withAlpha, type ChartPlugin } from '@kumo-charts/core';

const highlightBigBars: ChartPlugin = {
  name: 'big-bars',
  paint: ({ ctx, layer, pane, bars, visible, indexToX, barSpacing, theme }) => {
    if (layer !== 'below' || pane.id !== 'main' || !visible) return;
    ctx.fillStyle = withAlpha(theme.accent, 0.08);
    for (let i = visible.from; i <= visible.to; i += 1) {
      if (bars.high(i) - bars.low(i) > 500) {
        ctx.fillRect(indexToX(i) - barSpacing / 2, 0, barSpacing, pane.height);
      }
    }
  }
};

상태와 다시 그리기

플러그인 자체의 설정이 바뀌면 차트를 한 번 다시 그리게 해야 합니다. attach에서 host를 받아 두고 host.repaint()를 호출합니다.

import type { ChartPlugin } from '@kumo-charts/core';

function watermark(initial: string) {
  let text = initial;
  let repaint = () => {};

  const plugin: ChartPlugin = {
    name: 'watermark',
    attach: (host) => {
      repaint = host.repaint;
    },
    paint: ({ ctx, layer, pane }) => {
      if (layer === 'below' && pane.id === 'main')
        ctx.fillText(text, pane.width / 2, pane.height / 2);
    }
  };

  return {
    plugin,
    setText(next: string) {
      text = next;
      repaint();
    }
  };
}

host.chart는 차트 자체이므로 플러그인은 유형 등록이나 이벤트 구독 등 차트의 모든 API를 쓸 수 있습니다. 플러그인이 제거되거나 차트가 파기되면 detach가 호출되므로, 여기서 직접 등록한 리스너를 해제합니다.

chart.plugins.add(plugin);
chart.plugins.list(); // 그리는 순서대로 플러그인을 나열
chart.plugins.remove('watermark');

캔버스 또는 HTML

클릭하거나 입력할 수 있어야 하는 것, 예를 들어 차트 위에 떠 있는 버튼이나 입력 상자는 HTML 요소를 차트 위에 겹치는 편이 낫습니다. chart.layout()으로 각 창의 위치를 얻고, priceScale().priceToY(), timeScale.timeToX()로 좌표를 변환하고, visibleRangeChange가 발생할 때 위치를 갱신합니다. 보기만 하면 되는 것은 플러그인으로 캔버스에 그리는 편이 성능이 좋고, 스크린샷에도 함께 담깁니다.

플러그인은 직접 만든 지표, 그리기 유형과 함께 하나의 모듈로 묶을 수 있습니다. 사용자 정의 모듈을 참고하세요.

↑↓ 선택 · Enter 열기 · Esc 닫기