July 6, 2020

发表轻量图表3.0版

我们很高兴发表 轻量图表3.0版。我们增加了同时具有两个价格刻度、从可见数据的左侧/右侧确定K线计数、使用自己的日期格式、覆盖自动刻度范围等等的功能。在这篇文章中,我们将引导您完成所有这些更新,并向您展示如何开始使用我们最新版本的轻量级图表。

重大更新

首先,这是本编程库的主要发行版本,有一些重大更改:

  • subscriptionVisibleTimeRangeChangeunsubscribeVisibleTimeRangeChange 这两种方法都从ChartApi移至TimeScaleApi。
  • 在3.0版本中,您可以指定要放置系列的价格轴。在价格范围之间移动序列也是如此。

请阅读我们的重大变更文件以及全面的指南,以帮助您顺利迁移。

 

两种价格刻度

自从我们的第一个公开版本以来,编程库只能(同时从左或从右)显示一个价格范围。在3.0版中,您同时可以显示两个价格范围。这意味着您可以在图表上增加两个不同的系列,将它们设置为不同的价格刻度(一个在左侧,另一个在右侧),它们都将可见。此外,您可以将多个系列以相同的价格刻度放置,即使它们是重叠的。因此,您可以使用多个输出端来建立自己的研究,在此您可以将每个输出端作为一个单独的序列,并将它们全部置于相同的价格范围内,以便将它们一起缩放对比。

计算K线和K线的可见性

假设您开发了一个app,并且需要在用户滚动屏幕到历史记录的左侧(在此处查看)时实现连续数据加载。这是图表解决方案的相当基本的功能。

3.0版具有与此功能相关的许多改进。例如,您现在可以从左侧可见K线的左侧,或右侧可见K线的右侧获取关于系列有多少K线的信息。您现在还可以进行预测并提前加载新的K线,这样用户就不会看到任何“冻结”或加载延迟。例如,假设您在用户向左滚动屏幕时开始加载其他K线,因此历史记录中仅剩下50-100条K线。

此外,API还可以应用于在多个图表之间平滑同步可见范围(例如,在TradingView的多图表上看到的)。当一个图表移动时,其他图表也会移动。

 

日期格式

以前,我们有可用日期格式的硬编码列表(总共19种格式),因此您无法自定义和使用自己的格式,当时这样更适合您的需求。

现在,我们在3.0版对此进行了更改,允许您将任何自定义字符串用作日期格式。例如,您可以使用 ‘yyyy-dd’ 甚至 ‘yyyy’,它们适用于季节性图表。

自定义格式可以是任何字符串,包含任意数量的日期占位符,然后我们将其替换为相应的日期值:

  • `yyyy` – 完整年份名称(例如2020年)
  • `yy` – 简写年份名称(例如20)
  • `MMMM` – 完整月份名称(例如July)
  • `MMM` – 简写月份名称(例如Feb)
  • `MM` – 数字(如果需要,前导字为0)月份(例如03)
  • `dd` – 每月的某天(如果需要,前导字为0)(例如15)

 

覆盖系列价格范围

预设情况下,在自动缩放模式下,编程库会使用图表上的所有可见数据来计算价格范围。但是,如果您想以某种方式对其进行修改,例如,如果您确定该系列不应该具有负值,则可以更改价格范围,使其可以展现为非负数,编程库将相应采用价格范围。

 

在系列标记添加文字

系列标记(series markers)可用于改善图表的用户体验。它们使您可以在一系列K线的旁边显示标记(例如箭头、圆形或正方形)。在我们的新版本库中,您还可以为每个标记指定签名或文字,从而可以添加标题和注释。

API将时间转换为坐标,反之亦然

有时,有必要在图表的特定时间在程式库顶部放置提示或文字。在3.0版中,我们增加了将时间转换为X坐标(反之亦然)的功能,实质上是由API设置了屏幕坐标。此外,您现在可以获得可见的价格刻度的宽度(左或右)。例如,如果您显示了左侧的价格刻度,并且需要在图表内获取精确的坐标,这将很有用。

隐藏价格刻度tick标记的能力

价格刻度上的tick标记有时似乎有些令人困惑,因为它们看起来像减号。但是,现在您可以禁用此符号,从而使编程库停止显示。这意味着如果您想让空间更一目了然些,就不会再有令人混淆的符号在图表里了。

更多功能,更小包装

“轻量”的含义之一是指大小。本编程库的第一个版本在min.gz中约为43.7KB。从那时起,我们增加了许多新功能,您可能会猜它的大小会跟着这些增加项目而增加,呵呵~猜错了!

在此版本中,我们应用了各种技术来减少程式库的大小,让您可以有更小的包装。因此,本编程库的3.0版在min.gz中为42.4KB,甚至比以前更小,但是装满了许多新增的功能和工具。

请注意,我们此处使用的技术并非专门针对轻量图表。意味着您也可以在专案中使用它们。如果您有兴趣了解有关我们流程的更多资讯,请查看以下 GH #436GH #432,它们在编程库中突显了缩减的大小。我们的测试指出,这些技术可以使包装的大小以最小的未压缩形式减少多达30%,以min.gz形式减少多达10%。

 

特别感谢我们的社区

TradingView是投资人、交易者、和程序员的社区。我们要感谢所有对此发行版本提供帮助的贡献者:

 

我们还有更多东西要给你看

这篇文章只是关于轻量图表3.0的新功能而已。要查看变更的完整列表,我们建议您查看我们的Github notes以获取更多细节。如果您想了解有关轻量图表如何为您提供帮助的更多资讯,请造访我们的图表库

希望您喜欢此更新。与往常一样,请继续向我们发送您的意见、建议、和反馈。我们很高兴为您开辟新航道。

 

 


 

还没有关注我们的中文微信公众号?快来扫二维码吧!

 

 

Look first / Then leap

开启图表