# 10、版本變更點 # 版本變更點 我們將盡最大努力使每個新版本與前一版本完全兼容，但有時重大的更改需要您在升級到新版本時對代碼進行微小的更改。 *注意：您可以通過在瀏覽器控制臺中執行 `TradingView.version()` 來檢查圖表庫版本。* 以下是變更列表： ## Version 1.14 - [createButton](Widget-Methods.html#createButtonoptions) 返回 `HTMLElement` 以代替 `JQuery`. - [createButton](Widget-Methods.html#createButtonoptions) 必須在 [headerReady()](Widget-Methods.html#headerready)返回的 `Promise` 為resolved之后使用. **TypeScript 類型定義** - `StudyInputValueType` 改名為 `StudyInputValue`. **功能集** - 從此版本開始，您將無法再使用`keep_left_toolbar_visible_on_small_screens`功能集。 此功能集已刪除，左側工具欄可見性不再取決于屏幕大小。 ## Version 1.13 - 動作 `takeScreenshot` 從 [executeActionById](Chart-Methods.html#executeactionbyidactionid) 方法中被刪除。 改用 [takeScreenshot](Widget-Methods.html#takescreenshot) 方法。 - 動作 `lockDrawingsAction` 從[executeActionById](Chart-Methods.html#executeactionbyidactionid) 和 [getCheckableActionState](Chart-Methods#getcheckableactionstateactionid) 方法中被刪除。 改用[lockAllDrawingTools](Widget-Methods#lockalldrawingtools) 代替。 - 動作 `hideAllDrawingsAction` 從 [executeActionById](Chart-Methods.html#executeactionbyidactionid) 和 [getCheckableActionState](Chart-Methods#getcheckableactionstateactionid) 方法中被刪除。 改用[hideAllDrawingTools](Widget-Methods#hidealldrawingtools) 代替。 - 功能集 `caption_buttons_text_if_possible` 默認開啟。 - 修復一個[問題](https://github.com/tradingview/charting_library/issues/2652) 導致K線發生偏移。當日K線有一個負交易所時區偏移至24x7交易時段時，會出現K線的偏移。 如果您已通過變通方法解決此問題，請在更新此版本之前將其刪除。 ## Version 1.12 **圖表庫** - `charting_library/charting_library.min.js` 現在為 [UMD](https://github.com/umdjs/umd) 通用模塊規范。 如果您只是將這個腳本嵌入到HTML中 - 沒有任何改變。 但是，如果將它作為模塊導入，則應該直接導入它的`widget`，`version`和`onready`函數。 - `searchSymbolsByName` 從 `JS-API` 中移除, 使用 `searchSymbols` 代替。 指標覆蓋: - `Overlay` 的覆蓋只能通過 `studies_overrides` (或運行時的 `applyStudiesOverrides` )。 在以前版本中您可以使用 `overrides` 和 `applyOverrides`). 參見 [指標覆蓋](Studies-Overrides.html) 頁. - 從這個版本開始，您將不能再使用 `options` 關鍵字以覆蓋 `showStudyArguments` 和 `showLastValue` 。 **交易終端** - `hasHistory` flag 被刪除。 使用 `historyColumns` 來顯示賬戶管理器中的歷史記錄。 交易終端中仍然支持以下內容，但在未來的版本中將不再使用：: - `subscribePL` 和 `unsubscribePL`。 每當損益變化時經紀商應該調用 `plUpdate` 方法。 - `supportDOM` 被刪除。 DOM widget 的可見性可以使用 `dome_widget` 功能集。 **交易控制器被替換為[經紀商API](Broker-API.html)**. 下列變更將讓您的交易控制器實現遷移到新的經紀商API: - 方法 `setHost` 被刪除。 主機將傳遞給經紀商API的構造函數。 - 方法 `buttonDropdownItems` 被刪除。 經紀商API將使用 `setButtonDropdownActions` 更新[交易主機](Trading-Host.html)。 - 方法 `configFlags` 和 `durations` 被刪除。 使用 [Widget構造器](Widget-Constructor.html) 的字段代替。 - 全部方法返回 `$.Deferred` 的變為返回 Promise。 - 方法 `chartContextMenuItems` 重命名為 `chartContextMenuActions`。 - 方法 `isTradable` 變更為返回一個Promise的布爾值。 - 全部字符串常量 ("working", "buy" etc.) 被替換為數字常量 - 倉位的 `avg_price` 重命名為 `avgPrice`。 - `tradingController` 字段在 [Widget構造器](Widget-Constructor.html) 被刪除。 改用 `brokerFactory`。 ## Version 1.11 **交易終端** 交易終端中仍然支持以下內容，但在未來的版本中將不再使用： - `supportDOME` 重命名為 `supportDOM` - 更改了 `showClosePositionDialog` 的簽名 - `showEditBracketsDialog` 重命名為 `showPositionBracketsDialog`, 更改了簽名。 ## Version 1.10 - 更改成交量指標的默認行為。 先前的行為：在儀表或周期切換時，根據成交量支持選項來確定成交量指標的添加/刪除。 您可以通過禁用`create_volume_indicator_by_default_once` 功能集來恢復到此行為。 新的行為：如果當前儀表支持成交量，則在空白圖表的第一次加載時會添加成交量指標。 ## Version 1.9 - 我們不再編譯更多Pine腳本。您仍然可以使用以前編譯過的腳本。 ## Version 1.8 的交易終端 - 圖表不可以只顯示當前訂單。適當的方法已被刪除。 - `showOrderDialog` 輸入參數時一個對象而不是列表 - `showSampleOrderDialog` 已被移除。 請使用 [showOrderDialog](Trading-Host.html#showorderdialogorder-handler) 代替。 - 在 [交易控制器](Trading-Controller.html) 中刪除`showOrderDialog`, 使用 `placeOrder` 和 `modifyOrder` 接收 `silently` 參數。 - `reversePosition`, `closePosition`, `cancelOrder` 有一個額外的參數 `silently`. 從現在起他們有了自己的對話框。 ## Version 1.7 - 從這個版本開始不能夠用相同的商品代碼調用 `setSymbol`。 您應該先從 `subscribeBars` 調用 `onResetCacheNeededCallback` 開始。 然后您才可以使用圖表的 `setSymbol` 或 新的 `resetData` 方法。 - JSAPI 協議版本 1 不在被支持。必須提供 `nextTime` 和 `noData`。 ## Version 1.5 - 添加 `source` 參數給 MACD. 您也可以通過創建代碼傳遞 `source` 參數來改變 MACD 。 `chartWidget.chart().createStudy('MACD', false, false, [12, 26, "close", 9])` ## Version 1.4 - 覆蓋 `transparency` 不在被支持。 我們為每個顏色數據添加了透明度支持。 使用 `rgba` 來定義顏色的透明度。 例如: `"symbolWatermarkProperties.color" : "rgba(60, 70, 80, 0.05)"` ## Version 1.3 - 覆蓋 `paneProperties.gridProperties.*` 不在被支持。 請使用 `paneProperties.vertGridProperties.*` 和 `paneProperties.horzGridProperties.*` - 覆蓋 `mainSeriesProperties.candleStyle.wickColor` 不在被支持。 請使用 `mainSeriesProperties.candleStyle.wickUpColor` 和 `mainSeriesProperties.candleStyle.wickDownColor`