📠 Change Log
10.0.0-beta2
2026-05-20
🆕 New Features
- Support multiple y-axes. Multiple y-axes can be created in the same pane, and indicators can be bound to a specified y-axis through
yAxisId. - Add instance methods
overrideXAxis(options)andoverrideYAxis(options)for independently configuring the x-axis and y-axis. - The chart now supports automatically listening to container size changes and calling
resize(). - Add the
texttype to indicator figures, allowing indicatorfiguresto draw text directly.
- Support multiple y-axes. Multiple y-axes can be created in the same pane, and indicators can be bound to a specified y-axis through
👉 Changes
- In the chart method
init(ds, options),options.layouthas been changed from an array structure to an object structure, withbasicParamsandpanesadded:basicParamssupports configuringbarSpaceLimitMin,barSpaceLimitMax,yAxisPosition,yAxisInside,paneMinHeight, andpaneHeight.panesis used to configure pane layout, and pane content supports specifying a y-axis configuration for an indicator through{ indicator, yAxis }.
- The instance method
createIndicator(indicator, isStack?, paneOptions?)has been changed tocreateIndicator(indicator, options?), andoptionssupportsisStack,pane, andyAxis. setPaneOptions(options)no longer includes axis configuration. UseoverrideXAxis(options)oroverrideYAxis(options)for axis configuration.- Add
yAxisIdto thefilterparameter ofconvertToPixel(value, filter?)andconvertFromPixel(coordinate, filter?).
- In the chart method
🐞 Fixed the parameter type error of the instance API
setZoomAnchor.💄 Optimized the build process. The build tool has been changed from rollup to Vite, and
type-checkhas been added.
10.0.0-beta1
2025-11-21
🆕 New Features
- Support thousands separators and custom decimal collapse.
- Support displaying future time on the x-axis.
- Support dragging the y-axis on mobile devices.
- Support creating multiple metrics with the same name on the same window.
- Rewrote the axis module; custom y-axis supports setting the range.
- Add
zoomAnchorto theoptionsmethod of the chart methodinit(dom, options). - New instance methods
setZoomAnchor(anchor),getZoomAnchor(),setDataLoader(loader),setSymbol(symbol),getSymbol(),setPeriod(period),getPeriod(),resetData(),setThousandsSeparator(thousandsSeparator),getThousandsSeparator(),setDecimalFold(decimalFold),getDecimalFold(),getIndicators()andgetOverlays(). - Add style configurations:
candle.priceMark.last.extendTexts,candle.tooltip.title,candle.tooltip.legend,indicator.tooltip.title,indicator.tooltip.legend,crosshair.horizontal.features,candle.bar.compareRule,indicator.ohlc.compareRule, andcandle.priceMark.last.compareRule. - Add
onIndicatorTooltipFeatureClickandonCrosshairFeatureClickto thetypeparameter in the instance methodssubscribeActionandunsubscribeAction.
👉 Changes
- In the chart method
init(dcs, options), thepositionsub-item ofoptions.layouthas been changed toorder,options.thousandsSeparatorhas been changed to the object{ sign, format },options.decimalFoldThresholdhas been changed tooptions.decimalFold,options.customApihas been changed tooptions.formatter, and the parameter offormatDatehas been changed to an object. - In the instance methods
setCustomApiandgetCustomApihave been changed togetFormatter, the return value ofgetBarSpace()has been changed to an object, the return value ofcreateIndicatorhas been changed to return the indicator ID, and the input parameterpaneIdofoverlayIndicatorhas been merged into the input parameterindicator. - The return value of the custom metric
createTooltipDataSourcemethod has been changed fromvaluestolegends, andiconstofeatures. - The style configurations
candle.tooltip.iconsandindicator.tooltip.iconshave been changed toindicator.tooltip.features.
- In the chart method
💄 Optimizations
- Optimized the
figureelement in the overlay template to ignore event types, ensuring the event name matches the event name inoverlay. - Optimized the execution of metric calculation tasks.
- Optimized the triggering of scroll events on mobile devices.
- Optimized the
🗑 Deprecated
- The following chart methods have been removed:
utils.drawArc(ctx, arc, styles),utils.drawCircle(ctx, circle, styles),utils.drawLine(ctx, line, styles),utils.drawPolygon(ctx, polygon, styles),utils.drawRect(ctx, rect, styles),utils.drawText(ctx, text, styles),utils.drawRectText(ctx, rectText, styles). Please usegetFigureClass(name)instead. - The following instance method has been removed:
setPriceVolumePrecision(pricePrecision, volumePrecision). Please usesetPrecision(precision)instead. - In the instance API, remove
setLoadMoreData,applyNewData, andupdateData. Replace them withsetDataLoader. RemoveclearData,setPrecision, andgetPrecision. - In the instance method, remove
getIndicatorByPaneId(paneId, name). Replace it withgetIndicators(filter). - In the instance method, remove
getOverlayById(id). Replace it withgetOverlays(filter). - In the instance methods
subscribeActionandunsubscribeAction, remove the parameteronTooltipIconClick. Replace it withonCandleTooltipFeatureClickandonIndicatorTooltipFeatureClick. - The style configuration removes
yAxis.position,yAxis.type,yAxis.inside, andyAxis.inside. Please use[overrideYAxis(options)](/api/instance/overrideYAxis#parameters)instead. For details, see the chart API[init(dcs, options)](/api/chart/init#parameters), the instance APIs[createIndicator(indicator, options)](/api/instance/createIndicator#parameters),[setPaneOptions(options)](/api/instance/setPaneOptions#parameters), and[overrideYAxis(options)](/api/instance/overrideYAxis#parameters). - In style configuration, remove
candle.tooltip.defaultValueand replacecandle.tooltip.customwithcandle.tooltip.legend. Also removecandle.tooltip.text,indicator.tooltip.showName, andindicator.tooltip.showParams; useindicator.tooltip.titleinstead. Removeindicator.tooltip.defaultValueand replace it withindicator.tooltip.legend. Also removeindicator.tooltip.textandoverlay.rectText. - In built-in basic graphics, remove
rectTextand replace it withtext.
- The following chart methods have been removed:
9.x
Go to https://v9.klinecharts.com to check the change log for 9.x.
8.x
Go to https://v8.klinecharts.com to check the change log for 9.x.
7.x
Go to Github to check the change log for 7.x.
6.x
Go to Github to check the change log for 6.x.
5.x
Go to Github to view the 5.x release notes.
4.x
Go to Github to view the 4.x release notes.