Kumo Charts

保存和恢复

用户在图表上加的指标、画的线、调过的窗格,可以一次存下来,下次打开时一次恢复。

// 存
const state = chart.saveState();
localStorage.setItem('layout', JSON.stringify(state));

// 恢复
const saved = localStorage.getItem('layout');
if (saved) chart.loadState(JSON.parse(saved));

saveState() 返回的是普通对象,可以直接转成 JSON,存在浏览器里或者你的服务器上。

存了什么

  • 主图的图形类型和画哪个价格(mainSeries.type、mainSeries.source)。
  • K 线变换,比如平均 K 线、砖形图和它们的参数(transform)。
  • 视图:K 线的宽度和离最新一根有多远。
  • 窗格:有哪些、顺序、高度、标题,每个价格坐标的模式(对数、百分比等)、是否翻转、手动设的范围和上下留白。
  • 各个模块自己的部分:指标模块存全部指标和它们的参数、样式;画线模块存全部画线;成交量分布模块存全部分布。

没有存的是属于你的应用的东西:K 线数据、周期、叠加的图形、委托单、成交标记、提醒。它们由应用自己管理,恢复布局后再设回去。

恢复

loadState() 要么全部恢复,要么什么都不改:状态里有任何一处不对,比如版本不认识、用了图表没有的指标类型、画线放在不存在的窗格里,它会报错,图表保持原来的样子。

try {
  chart.loadState(saved);
} catch (error) {
  console.warn('布局恢复失败,用默认布局', error);
}

恢复时图表要有同样的模块。状态里有画线,而图表没有画线模块,也会报错。

先设数据还是先恢复布局都可以,指标会跟着数据重新算。通常是建图、设数据、再恢复布局。

不同品种用不同的画线

画线是按时间和价格定位的,同一个品种换周期还能对上,换品种就对不上了。想让每个品种有自己的画线,又共用一套指标和窗格,就把画线单独存:

// 换品种前,存下这个品种的画线
drawingsBySymbol[symbol] = chart.drawings.list();

// 换到新品种
chart.data.set(barsOf(next), { interval: '1m' });
chart.drawings.set(drawingsBySymbol[next] ?? []);

drawings.set() 会替换全部画线,并清空撤销记录。

版本

状态里有 version,现在是 1。以后状态的格式变了,版本号会跟着变;loadState() 遇到不认识的版本会报错。

↑↓ 选择 · Enter 打开 · Esc 关闭