Vue と React
<script setup lang="ts">
import { ref } from 'vue';
import { KumoProChart } from '@kumo-charts/pro-chart/vue';
const symbol = ref('600519.SH');
const theme = ref<'light' | 'dark'>('light');
</script>
<template>
<div style="height: 600px">
<KumoProChart
:options="{ datafeed, upColor: 'red', theme }"
v-model:symbol="symbol"
@indicators-change="save"
@button-click="({ id }) => id === 'trade' && openTicket()"
@created="(c) => (chart = c)"
/>
</div>
</template>import { KumoProChart } from '@kumo-charts/pro-chart/react';
const options = useMemo(() => ({ datafeed, upColor: 'red', theme }), [theme]);
<div style={{ height: 600 }}>
<KumoProChart
options={options}
symbol={symbol}
onSymbolChange={(event) => setSymbol(event.symbol)}
onIndicatorsChange={save}
onCreated={setChart}
/>
</div>;- コンポーネントの名前は
KumoProChartで、オープンソース版のKumoChartに対応します。createProChart()が返すチャートオブジェクトの型はProChartです。 optionsのうちapplyOptions()で変えられるもの(テーマ、言語、色、画面の文言、機能の切り替え、ボタンとメニュー、ウォッチリスト、描画ツールバー……)は追従します。新しいオブジェクトを渡すと(Vue ではリアクティブなオブジェクトのキーを変えても同じ)、変わったものをapplyOptions()で反映し、外したものはデフォルトに戻ります。features、messages、themesはapplyOptions()と同じくキーごとにマージします。datafeed、storage、customIndicatorsのようなものはマウント時に 1 回だけ読みます。React ではuseMemoなどで、変わっていないときはオブジェクトを同じものに保ち、レンダーのたびに作り直さないでください。それ以外の操作は、createdで渡されるチャートオブジェクトを通して行います。symbolとtimeframeはプロパティとしてバインドできます。プロパティが変わるとチャートも変わります。symbolやtimeframeをバインドしたときはページが決め、開いたときもその値を使い、ユーザーが最後に見ていたものは復元しません。Vue ではv-model:symbol、v-model:timeframeで双方向にバインドし、React ではonSymbolChange、onTimeframeChangeと組み合わせます。symbolをバインドしたときはoptionsに書かなくても構いません。- ページが渡したものをチャートが受け付けないとき(データフィードで見つからない銘柄、提供していない時間足、書き間違えたオプションなど)は、チャートは元のままで、Vue の
@prop-error、React のonPropErrorが{ prop, value, error }を受け取ります。propはsymbol、timeframe、optionsのいずれか、valueはページが渡した値(optionsのときは変わったオプション)、errorは対応するメソッド(setSymbol()、setTimeframe()、applyOptions())が reject したエラーです。リスナーがないと、エラーは誰も処理しない Promise の reject として投げられ、ブラウザのコンソールで確認できます。コンポーネントのアンマウント時にまだ順番が来ていなかったプロパティは報告しません。 - どのイベントも直接リッスンできます。Vue では
@symbol-change、@indicators-change、@crosshair-move……、React ではonSymbolChange、onIndicatorsChange、onCrosshairMove……で、常に最新のレンダーで渡された関数を呼びます。created(React ではonCreated)はコンポーネントのマウント時にチャートオブジェクトを渡し、最初のチャートができるのを待ちません。readyはほかのイベントと同じく、最初のチャートができたときに発火します。 - React は 18 と 19 に対応し、StrictMode も含みます。