Skip to main content
Version: Next

Interface: IChartApi

The main interface of a single chart using time for horizontal scale.

Extends​

Methods​

applyOptions()​

applyOptions(options): void

Applies new options to the chart

Parameters​

• options: DeepPartial <TimeChartOptions>

Any subset of options.

Returns​

void

Overrides​

IChartApiBase . applyOptions

remove()​

remove(): void

Removes the chart object including all DOM elements. This is an irreversible operation, you cannot do anything with the chart after removing it.

Returns​

void

Inherited from​

IChartApiBase . remove

resize()​

resize(width, height, forceRepaint?): void

Sets fixed size of the chart. By default chart takes up 100% of its container.

If chart has the autoSize option enabled, and the ResizeObserver is available then the width and height values will be ignored.

Parameters​

• width: number

Target width of the chart.

• height: number

Target height of the chart.

• forceRepaint?: boolean

True to initiate resize immediately. One could need this to get screenshot immediately after resize.

Returns​

void

Inherited from​

IChartApiBase . resize

addCustomSeries()​

addCustomSeries<TData, TOptions, TPartialOptions>(customPaneView, customOptions?, paneIndex?): ISeriesApi<"Custom", Time, TData | WhitespaceData <Time>, TOptions, TPartialOptions>

Creates a custom series with specified parameters.

A custom series is a generic series which can be extended with a custom renderer to implement chart types which the library doesn't support by default.

Type parameters​

• TData extends CustomData <Time>

• TOptions extends CustomSeriesOptions

• TPartialOptions extends DeepPartial<TOptions & SeriesOptionsCommon> = DeepPartial<TOptions & SeriesOptionsCommon>

Parameters​

• customPaneView: ICustomSeriesPaneView <Time, TData, TOptions>

A custom series pane view which implements the custom renderer.

• customOptions?: DeepPartial<TOptions & SeriesOptionsCommon>

Customization parameters of the series being created.

const series = chart.addCustomSeries(myCustomPaneView);

• paneIndex?: number

Returns​

ISeriesApi<"Custom", Time, TData | WhitespaceData <Time>, TOptions, TPartialOptions>

Inherited from​

IChartApiBase . addCustomSeries

addSeries()​

addSeries<T>(definition, options?, paneIndex?): ISeriesApi<T, Time, SeriesDataItemTypeMap <Time>[T], SeriesOptionsMap[T], SeriesPartialOptionsMap[T]>

Creates a series with specified parameters.

Type parameters​

• T extends keyof SeriesOptionsMap

Parameters​

• definition: SeriesDefinition<T>

A series definition.

• options?: SeriesPartialOptionsMap[T]

Customization parameters of the series being created.

• paneIndex?: number

An index of the pane where the series should be created.

const series = chart.addSeries(LineSeries, { lineWidth: 2 });

Returns​

ISeriesApi<T, Time, SeriesDataItemTypeMap <Time>[T], SeriesOptionsMap[T], SeriesPartialOptionsMap[T]>

Inherited from​

IChartApiBase . addSeries

removeSeries()​

removeSeries(seriesApi): void

Removes a series of any type. This is an irreversible operation, you cannot do anything with the series after removing it.

Parameters​

• seriesApi: ISeriesApi<keyof SeriesOptionsMap, Time, CustomData <Time> | WhitespaceData <Time> | AreaData <Time> | BarData <Time> | CandlestickData <Time> | BaselineData <Time> | LineData <Time> | HistogramData <Time> | CustomSeriesWhitespaceData <Time>, CustomSeriesOptions | AreaSeriesOptions | BarSeriesOptions | CandlestickSeriesOptions | BaselineSeriesOptions | LineSeriesOptions | HistogramSeriesOptions, DeepPartial <AreaStyleOptions & SeriesOptionsCommon> | DeepPartial <BarStyleOptions & SeriesOptionsCommon> | DeepPartial <CandlestickStyleOptions & SeriesOptionsCommon> | DeepPartial <BaselineStyleOptions & SeriesOptionsCommon> | DeepPartial <LineStyleOptions & SeriesOptionsCommon> | DeepPartial <HistogramStyleOptions & SeriesOptionsCommon> | DeepPartial <CustomStyleOptions & SeriesOptionsCommon>>

Returns​

void

Inherited from​

IChartApiBase . removeSeries

Example​

chart.removeSeries(series);

subscribeClick()​

subscribeClick(handler): void

Subscribe to the chart click event.

Parameters​

• handler: MouseEventHandler <Time>

Handler to be called on mouse click.

Returns​

void

Inherited from​

IChartApiBase . subscribeClick

Example​

function myClickHandler(param) {
    if (!param.point) {
        return;
    }

    console.log(`Click at ${param.point.x}, ${param.point.y}. The time is ${param.time}.`);
}

chart.subscribeClick(myClickHandler);

unsubscribeClick()​

unsubscribeClick(handler): void

Unsubscribe a handler that was previously subscribed using subscribeClick.

Parameters​

• handler: MouseEventHandler <Time>

Previously subscribed handler

Returns​

void

Inherited from​

IChartApiBase . unsubscribeClick

Example​

chart.unsubscribeClick(myClickHandler);

subscribeDblClick()​

subscribeDblClick(handler): void

Subscribe to the chart double-click event.

Parameters​

• handler: MouseEventHandler <Time>

Handler to be called on mouse double-click.

Returns​

void

Inherited from​

IChartApiBase . subscribeDblClick

Example​

function myDblClickHandler(param) {
    if (!param.point) {
        return;
    }

    console.log(`Double Click at ${param.point.x}, ${param.point.y}. The time is ${param.time}.`);
}

chart.subscribeDblClick(myDblClickHandler);

unsubscribeDblClick()​

unsubscribeDblClick(handler): void

Unsubscribe a handler that was previously subscribed using subscribeDblClick.

Parameters​

• handler: MouseEventHandler <Time>

Previously subscribed handler

Returns​

void

Inherited from​

IChartApiBase . unsubscribeDblClick

Example​

chart.unsubscribeDblClick(myDblClickHandler);

subscribeCrosshairMove()​

subscribeCrosshairMove(handler): void

Subscribe to the crosshair move event.

Parameters​

• handler: MouseEventHandler <Time>

Handler to be called on crosshair move.

Returns​

void

Inherited from​

IChartApiBase . subscribeCrosshairMove

Example​

function myCrosshairMoveHandler(param) {
    if (!param.point) {
        return;
    }

    console.log(`Crosshair moved to ${param.point.x}, ${param.point.y}. The time is ${param.time}.`);
}

chart.subscribeCrosshairMove(myCrosshairMoveHandler);

unsubscribeCrosshairMove()​

unsubscribeCrosshairMove(handler): void

Unsubscribe a handler that was previously subscribed using subscribeCrosshairMove.

Parameters​

• handler: MouseEventHandler <Time>

Previously subscribed handler

Returns​

void

Inherited from​

IChartApiBase . unsubscribeCrosshairMove

Example​

chart.unsubscribeCrosshairMove(myCrosshairMoveHandler);

priceScale()​

priceScale(priceScaleId): IPriceScaleApi

Returns API to manipulate a price scale.

Parameters​

• priceScaleId: string

ID of the price scale.

Returns​

IPriceScaleApi

Price scale API.

Inherited from​

IChartApiBase . priceScale

timeScale()​

timeScale(): ITimeScaleApi <Time>

Returns API to manipulate the time scale

Returns​

ITimeScaleApi <Time>

Target API

Inherited from​

IChartApiBase . timeScale

options()​

options(): Readonly <ChartOptionsImpl <Time>>

Returns currently applied options

Returns​

Readonly <ChartOptionsImpl <Time>>

Full set of currently applied options, including defaults

Inherited from​

IChartApiBase . options

takeScreenshot()​

takeScreenshot(): HTMLCanvasElement

Make a screenshot of the chart with all the elements excluding crosshair.

Returns​

HTMLCanvasElement

A canvas with the chart drawn on. Any Canvas methods like toDataURL() or toBlob() can be used to serialize the result.

Inherited from​

IChartApiBase . takeScreenshot

panes()​

panes(): IPaneApi <Time>[]

Returns array of panes' API

Returns​

IPaneApi <Time>[]

array of pane's Api

Inherited from​

IChartApiBase . panes

removePane()​

removePane(index): void

Removes a pane with index

Parameters​

• index: number

the pane to be removed

Returns​

void

Inherited from​

IChartApiBase . removePane

swapPanes()​

swapPanes(first, second): void

swap the position of two panes.

Parameters​

• first: number

the first index

• second: number

the second index

Returns​

void

Inherited from​

IChartApiBase . swapPanes

autoSizeActive()​

autoSizeActive(): boolean

Returns the active state of the autoSize option. This can be used to check whether the chart is handling resizing automatically with a ResizeObserver.

Returns​

boolean

Whether the autoSize option is enabled and the active.

Inherited from​

IChartApiBase . autoSizeActive

chartElement()​

chartElement(): HTMLDivElement

Returns the generated div element containing the chart. This can be used for adding your own additional event listeners, or for measuring the elements dimensions and position within the document.

Returns​

HTMLDivElement

generated div element containing the chart.

Inherited from​

IChartApiBase . chartElement

setCrosshairPosition()​

setCrosshairPosition(price, horizontalPosition, seriesApi): void

Set the crosshair position within the chart.

Usually the crosshair position is set automatically by the user's actions. However in some cases you may want to set it explicitly.

For example if you want to synchronise the crosshairs of two separate charts.

Parameters​

• price: number

The price (vertical coordinate) of the new crosshair position.

• horizontalPosition: Time

The horizontal coordinate (time by default) of the new crosshair position.

• seriesApi: ISeriesApi<keyof SeriesOptionsMap, Time, CustomData <Time> | WhitespaceData <Time> | AreaData <Time> | BarData <Time> | CandlestickData <Time> | BaselineData <Time> | LineData <Time> | HistogramData <Time> | CustomSeriesWhitespaceData <Time>, CustomSeriesOptions | AreaSeriesOptions | BarSeriesOptions | CandlestickSeriesOptions | BaselineSeriesOptions | LineSeriesOptions | HistogramSeriesOptions, DeepPartial <AreaStyleOptions & SeriesOptionsCommon> | DeepPartial <BarStyleOptions & SeriesOptionsCommon> | DeepPartial <CandlestickStyleOptions & SeriesOptionsCommon> | DeepPartial <BaselineStyleOptions & SeriesOptionsCommon> | DeepPartial <LineStyleOptions & SeriesOptionsCommon> | DeepPartial <HistogramStyleOptions & SeriesOptionsCommon> | DeepPartial <CustomStyleOptions & SeriesOptionsCommon>>

Returns​

void

Inherited from​

IChartApiBase . setCrosshairPosition

clearCrosshairPosition()​

clearCrosshairPosition(): void

Clear the crosshair position within the chart.

Returns​

void

Inherited from​

IChartApiBase . clearCrosshairPosition

paneSize()​

paneSize(paneIndex?): PaneSize

Returns the dimensions of the chart pane (the plot surface which excludes time and price scales). This would typically only be useful for plugin development.

Parameters​

• paneIndex?: number

The index of the pane

Returns​

PaneSize

Dimensions of the chart pane

Inherited from​

IChartApiBase . paneSize

Default Value​

0

horzBehaviour()​

horzBehaviour(): IHorzScaleBehavior <Time>

Returns the horizontal scale behaviour.

Returns​

IHorzScaleBehavior <Time>

Inherited from​

IChartApiBase . horzBehaviour