ai/changelog.md

ℹ️ You can check the Charting Library version by executing TradingView.version() in a browser console.

Version 25

Date: Mon May 22 2023

Breaking Changes

• Save and Load Chart Templates. Add methods to the save/load adapter to support chart templates.
• Renew design for send order and buy sell buttons. Renew design for send order and buy sell buttons:
  • Buttons are now rounded
  • Selected item and underline are now black
• New TV logo. What is changing:
  • Changing the size, boldness of the text
  • Indentation of the logo from the borders of the chart
• One row for grid lines settings. The grid lines settings have been combined into one row.
• Remove magnet icon near cursor - Reverting feature. Following reviews this piece of work was reverted.
• Update Charting Library branding. Branding font and position is slightly changed.
• Do not load Euclid font for the branding logo on chart. The Euclid font will not load if there is an animated logo on the chart.
• When the chart data is reset, the new request for data will only be for the visible range. The previous behavior was that when resetData was evoked, that the datafeed would be requested to provide data for the entire range of data already loaded for that symbol. The new behavior is that the request is now only for the current visible range. This more closely matches the behavior of the first load. If you require the old behavior then you can disable the request_only_visible_range_on_reset featureset.
• Remove timezone & session breaks section from scale gear menu. Time zone and Session breaks section has been removed from gear menu.
• Update chart types icons. Changed icons for Line, Area and Baseline chart types.
• Move Session breaks from Appearance to Events tab. Session breaks setting is moved to events tab.
• Changed the gear icon. Changed the icon for price scale settings button ('gear' in bottom-right corner). See #1234

New Features

• Handle variable-tick-size. Added support for variable tick size.
• Add new stats position for info line drawing "auto". Option of automatic positioning of information block for infoline drawings was added "auto" (in addition to existing left, center, right).
• Add new checkboxes for price range in Info Line drawing box. Added 2 settings in linetools context menu:
  • Percent change
  • Change in pips
• Add ability to move anchors continuously - not by bars. Smooth resizing of icons, stickers and emojis was implemented.
• Correct Chart settings text Price scale labels. "LABELS" group in "Scales" tab of Chart settings has been renamed to "LABELS ON PRICE SCALE".
• Show + button on cursor by hotkey. Added hotkeys Alt+Ctrl (win) or Opt+Command (mac) for the appearance of the plus button under the cursor.
• Add Data window item to context/legend three dots menu. Added new item to context/legend three dots menu - "Data window..." with a shortcut. Opens Data Window in the right panel.
• Add Volume profile indicators on the top of chart series. Changed the default z-order for Volume Profile indicators and VP drawings. They are now located above the main series.
• Added new time zone Anchorage Alaska. Added new time zone Anchorage Alaska (UTC-9).
• Separate chart types Line with markers and Stepline. Step line and Line with markers types are added to the top toolbar chart types menu.
• Added new time zone Casablanca. Timezone Casablanca (UTC) has been added.
• Try to load line tools code dynamically. Fixed floating toolbar for Price Note to show color and text settings like for other drawings.
• Add sticker drawing tool. Add the ability to use stickers with createMultipointShape or selectLineTool.
• Add Accelerator Oscillator indicator.

Improvements

• Theming support for pop-up menus. Additional CSS custom properties have been added for styling pop-up menus. Pop-up (as known as 'pop-over') menus include toolbar menus, and context menus. See the full list of CSS custom properties in the CSS Color Themes article.
• Add date and time input UI for custom studies. Custom studies now support defining inputs of the 'time' type and having a GUI element (date and time pickers) in the indicators settings dialog window.
• setActiveChart added to the Widget API. The currently active chart in a multi-chart layout (available on Trading Terminal only) can now be changed using the setActiveChart method. more info

Bug Fixes

• Include missing PriceAxisLastValueMode and LineStyle enums in type documentation.

Documentation

• The Overrides article update. We have updated the Overrides article. Now it contains general information about the Overrides API. For information on how to customize elements on the chart, refer to a new Chart Overrides article.

Version 24.004

Date: Mon Apr 24 2023

New Features

• Indicators can now be favorited. Indicators can now be favorited by tapping on the star icon to the left of the indicator name. Favorited indicators will appear at the top of the indicator list.
  • The items_favoriting featureset should be enabled. more info
• Adding two featuresets to hide the right_toolbar or its tabs. There are 2 new featuresets hide_right_toolbar & hide_right_toolbar_tabs plus an additional WidgetBar API changeWidgetBarVisibility to control the right toolbar.
  • hide_right_toolbar allows you to instantiate the toolbar without showing it in the UI.
  • hide_right_toolbar_tabs will do the same with the exception of not showing tabs when displaying the right toolbar.

Improvements

• Added a middle band for the RSI indicator. Unlike on tradingview.com RSI was not presenting the option to plot a middle limit.
• Indicators favorites can now be defined within widget constructor. Indicators can now be defined as favorites using the favorites property of the widget constructor options. See Favorites.indicators for more information.
• Add a way to independently clear bar marks/timescale marks. clearMarks method has been enhanced to pass in an option to choose which marks should be cleared on the chart.
  • By default behaviour will remain similar and both bar & TimeScale marks will be removed.
  • Passing ClearMarksMode.BarMarks will only remove bar marks.
  • Passing ClearMarksMode.TimeScaleMarks will only remove TimeScale marks.
• BREAKING CHANGE Discrepancy in chart style/type methods. Only TypeScript breaking change as an interface has been renamed to better reflect its purpose. SeriesStyle is now SeriesType.

Bug Fixes

• load_study_template event is not emitted. load_study_template event was not emitted when applying a template on the chart.
• Fixed autosize bug occurring on Chrome iOS when rotating the device. Workaround fix for a browser bug until Chrome resolves the issue on their side.
• Fixed the type definitions for a few of the PineJS Std library functions. PineJSStd documentation.

Documentation

• New Key Features article. We have added the Key Features article that lists features supported/unsupported in Charting Library and Trading Terminal.
• How to connect data via Datafeed API. We have added a new tutorial on connecting data via Datafeed API. It will help you implement datafeed and real-time data streaming to Charting Library step-by-step.

Other

• Incorrect watermark property key. Deprecated symbolWatermarkProperties property has now been removed. Please use settings_adapter with symbolWatermark key instead or applyOverrides to change values.

Version 24.003

Date: Tue Apr 11 2023

New Features

• Images within bar marks. Bar marks now support the rendering of images as the background by specifying the imageUrl property. Please see the Mark interface for more details.
• Price Source and Long Description symbol info fields. Add support for displaying the price source and long description fields from the symbol info.
  • To enable the price source first add symbol_info_price_source to the list of enabled features. Then it will be shown in the legend, if available. It can be hidden through the legend context menu and the series property dialog.
  • To enable the long description first add symbol_info_long_description to the list of enabled features. Then it will be shown in the legend, if available. It can be hidden through the legend context menu and the series property dialog.

Improvements

• Added more styling options for bar marks. The styling options for bar marks has been expanded to include options for styling the border.
  • Border color can be set using the border property within color of the Mark interface. See MarkCustomColor
  • Border width can be set using borderWidth and hoveredBorderWidth. See Mark
• Drawing tools favorites can now be defined within widget constructor. Drawing tools can now be defined as favorites using the favorites property of the widget constructor options. See Favorites.drawingTools for more information.
• Context menu API can now be used within the Watchlist. watchlist_context_menu featureset is enabled by default. See onContextMenu for more details.
• Improved typings within package.json. The package.json bundled with the library has been improved to support newer versions of node, and offer improved typings. See NPM for more details.
• Price scale now supports numbers with more than 10 decimal points.
• Timezone data has been updated.

Bug Fixes

• Chart type won't change when restoring default options. The chart type will no longer change when restoring the default options within the chart settings dialog.
• Last visible bar value in legend for overlay studies. When use_last_visible_bar_value_in_legend featureset is enabled, overlay studies will display the value for the last visible item on the chart. This now matches the behavior for the main series.
• Fixed zoom behavior for percentage right margin option. Incorrect zooming behavior has been fixed for zoom buttons appearing on the chart, and the keyboard shortcuts. See show_percent_option_for_right_margin featureset for more information.

Documentation

• Add FAQ about unsubscribeBars delay. Added a new FAQ about unsubscribeBars being called with a delay.

Other

• Added symbol information to datafeed error messages. Added symbol information to realtime subscription error messages to improve the developer experience.
• Updated localisation list. The list of support localisations has been updated. Additionally, the chart will now fallback to english (with a console warning) if an unsupported locale is specified in the widget constructor options.

Version 24.002

New Features

• Added support for specifying custom timezones.
  • Additional custom timezones can now be specified for use within the library. Please see the Adding Custom Timezones section within the Timezones page.
• Images within timescale marks.
  • Timescale marks now support the rendering of images within the circular shape by specifying the imageUrl property. Please see the TimescaleMark interface for more details.
• Support different margin rates for different order types. 6607
  • marginRate has been deprecated
  • A supportLeverageButton flag that displays a leverage button has been added to the Broker configuration.
  • The supportLeverage flag enables leverage calculation by getting information from leverageInfo.

Enhancements

• Add horizontal line at 0 for Momentum study.

Bug fixes

• setUserEditEnabled does not hide 3 dots in Legend. 6765 | 6165

  widget.activeChart().getAllStudies().forEach(({ id }) => {
    console.log(id);
    tvWidget.activeChart().getStudyById(id).setUserEditEnabled(false);
  });
  

  • setUserEditEnabled(false) should mask all icons except the "eye".
  • setUserEditEnabled(true) should restore all the icons.

• priceFormatter could previously only be used for main series. priceFormatter now applies to secondary series as well.

• right_toolbar featureset didn't have a default on value.

• Empty time frames at the bottom toolbar if data_status: endofday

• Export data doesn’t include projected data.

  • Projected data can be included by setting includeOffsetStudyValues to true.
  • await widget.activeChart().exportData({ includeOffsetStudyValues: true });

• Highest PineJS.Std function doesn’t work correctly with negative numbers.

• Missing types in bundled definition file. 7445 | 7446

• Exposing icon prop in CreateShapeOptionsBase. 6723

• Wrong extended session background color 7443

Documentation

• Added migration guide from TAC to CTP.
• Added additional documentation for Drawings.
• Missing overrides in documentation. 7457
• Updated documentation for Marks.
• Align ChartMetaInfo & ChartData.

Other

• Removed Australia/ACT from the list of timezones within our documentation. Please use either the Sydney timezone or specify your own custom timezone.

Version 24.001

New Features

• Adding originalText as an additional field to UndoRedoState. Event should mention the name of the action in plain English in addition to also being translated to the corresponding language. UndoRedoState
• Add the ability to change X-Axis margin % from Chart Properties. A new featureset has been added show_percent_option_for_right_margin that adds additional percentage option to the right margin section of the chart settings dialog.
• Display rightmost visible value when in percent mode. A new featureset has been added use_last_visible_bar_value_in_legend to show the most recent “global” bar value. When this feature is enabled the rightmost bar in the visible range is used instead.
• Ability to change on the fly the Currency and Unit label setting. currencyAndUnitVisibility API
• Add simple SSR support. Allow the library to be imported within a NodeJS context. This improves support for frameworks such as Remix.
• Added clearUndoHistory.

Improvements

• Name to be used instead of ticker. Allow a human friendly name to be returned from symbol_search_complete.

Bug Fixes

• Incomplete indicators when using Heikin-Ashi. Indicator line should draw to all the visible data points.
• Compare study doesn’t save and restore ticker name correctly. The compare study should work for custom ticker names just like it does for ticker names which match our format (with the colon).
• VPFR: Right point is automatically moving when dragging start point. When drawing the VPFR, or moving one of the anchor points, it is expected that the right anchor point should not move one bar further to the right.
• Selecting Apply Defaults option within chart settings doesn’t work. Some Settings even if not validated are not restored to their original values when Apply Defaults is selected.
• Decentralised app browser loading error. Chart fails to load in wallet apps like MetaMask, Trust & Phantom. Enable the iframe_loading_compatibility_mode featureset to enable compatibility with these browsers.
• When disabled, widget bar still present a significant margin. Even when there aren't any pages or widget in the right toolbar and IF right_toolbar is disabled, contrary to the drawing toolbar that vanishes the widget bar stays there with the pill button to expand it whereas there isn't anything to expand.
• Can’t enable header_compare feature without header_symbol_search.
  • Disabling header_symbol_search should only hide the search button
  • Disabling header_compare should only hide the compare button
• Removed section of PostCSS syntax in bundled css files.

Other

• New Documentation site. 🎉
• Add shape to TimeScale. Shape property is described in TimescaleMark interface.
• Remove magnet icon near cursor.

Version 24

• preset Widget-Constructor parameter has been removed. Users can still use some featuresets to mimic the same behavior by disabling the following list:
  • 'left_toolbar', 'header_widget', 'timeframes_toolbar', 'edit_buttons_in_legend', 'context_menus', 'control_bar', 'border_around_the_chart'
• chart_style_hilo featureset is now enabled by default. This adds the High-low option to chart style controls dropdown. This featureset has been available since 1.15 but was previously disabled by default.
• Added typings for custom indicators. Typescript equivalents of our existing examples are available here: Custom Studies Typescript Examples.
• symbol_search_complete has changed. The function now takes an additional search result object parameter, and returns an additional human-friendly symbol name.

UI changes

• With this version you will notice that the top toolbar has been redesigned with the following changes:

  • Button padding & separator size have been reduced
  • Compare button has shifted next to Symbol
  • Drawing icon is now more prominent
  • New fullscreen icon
  • Save button style better highlights when there's a change
  • Top toolbar now extends to left & right edges
  • UI font changes to a default system one
  • Undo/redo buttons are now relocated next to the save button

Trading Terminal

• Default formatter textNoWrap has been removed.
• columnId field of SortingParameters has been renamed to property.
• Required id field has been added to column description.
• Type of formatter field in column description has been changed to StandardFormatterName | FormatterName.
• property field has been removed from column description. Use dataFields field instead.
• Type of formatter field in SummaryField has been changed to StandardFormatterName.

Older Versions

For breaking changes on older versions of the library please consult this page: Breaking Changes