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

開啟圖表