Skip to content

Bar Chart Model

Properties

dataStore

Type: any

Description: Data store object that can be used to store any data needed for the chart.
Default: {}

setupFinished

Type: Promise

Description: Promise that resolves when the setup process is complete.
Note: This promise does not need to be awaited if the setup method has already been awaited. It is simply provided as a way to await the setup process from other functions if needed to avoid race conditions.
Default: ...

aggregationType

Type: WebChartStatisticType

Description: The aggregation type for the bar chart. Must be one of the values allowed by WebChartStatisticType.

axisLabelsSymbol

Type: undefined | WebChartTextSymbol

Description: Axis labels text symbol (font, color, style).

axisLinesSymbol

Type: undefined | ISimpleLineSymbol

Description: Axis lines symbol (line width, style, color).

backgroundColor

Type: undefined | Color

Description: The background color of the chart.

binTemporalData

Type: boolean

Description: Whether temporal binning is enabled for all series in the config.
Note: Setting this prop removes any existing temporal binning settings if value is set to false.

chartId

Type: undefined | string

Description: The chart ID.

chartRenderer

Type: any

Description: The chart renderer.

chartSubtitleVisibility

Type: boolean

Description: Whether or not the chart subtitle is visible.
true: Chart subtitle is visible.
false: Chart subtitle is hidden.
Note: Even if the subtitle is visible, it may not be displayed if the subtitle text is empty.

chartSubType

Type: ChartSubType

Description: The chart sub type of the series.

chartTitleVisibility

Type: boolean

Description: Whether or not the chart title is visible.
true: Chart title is visible.
false: Chart title is hidden.
Note: Even if the title is visible, it may not be displayed if the title text is empty.

chartType

Type: ChartTypes

Description: The chart type.

colorMatch

Type: boolean

Description: Whether the chart should attempt to match the data source's colors.

true: Attempt to match the data source's colors.

false: Use the colors defined in the config.

config

Type: ChartConfig

Description: The current chart configuration object.

cursorCrosshair

Type: undefined | WebChartCursorCrosshair

Description: Cursor crosshair from the chart config.
Note: To set the cursor crosshair for the second Y-axis (axisIndex 2), ensure there is a second Y-axis in the chart by using the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

cursorCrosshairHorizontalLineVisibility

Type: boolean

Description: Visibility of the horizontal line of the cursor's crosshair.

cursorCrosshairStyle

Type: undefined | ISimpleLineSymbol

Description: Style of the cursor's crosshair from the chart config.
Note: To set the cursor crosshair style for the second Y-axis (axisIndex 2), ensure there is a second Y-axis in the chart by using the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

cursorCrosshairVerticalLineVisibility

Type: boolean

Description: Visibility of the vertical line of the cursor's crosshair.

dataLabelsSymbol

Type: undefined | WebChartTextSymbol

Description: Data labels text symbol (font, color, style).

dataLabelsVisibility

Type: boolean

Description: Whether data labels are visible.
true: visible, false: hidden.

descriptionSymbol

Type: undefined | WebChartTextSymbol

Description: The description text symbol. Contains styling information such as font, color, and symbol style.

descriptionText

Type: string

Description: The chart description text.

descriptionVisibility

Type: boolean

Description: Whether or not the chart description is visible.
true: Description is visible.
false: Description is hidden.
Note: Even if the description is visible, it may not be displayed if the description text is empty.

fetchNULLValues

Type: boolean

Description: Whether to fetch null values for them to be counted or displayed as categories on the chart.

guideLabelsSymbol

Type: undefined | WebChartTextSymbol

Description: The guide labels text symbol (font, color, style).

layer

Type: undefined | SupportedLayer

Description: The associated layer.

legendMaxHeight

Type: undefined | number

Description: Maximum legend height.

legendPosition

Type: WebChartLegendPositions

Description: Legend position: top, bottom, left, or right.

legendRoundMarker

Type: boolean

Description: Whether legend markers are rounded.

legendTextSymbol

Type: undefined | WebChartTextSymbol

Description: Legend item text symbol (font, color, style).

legendTitleSymbol

Type: undefined | WebChartTextSymbol

Description: Legend title text symbol (font, color, style).

legendTitleText

Type: string

Description: The legend title text.

legendTitleVisibility

Type: boolean

Description: Whether the legend title is visible.

true: Legend title is visible.

false: Legend title is hidden.

legendVisibility

Type: boolean

Description: Whether the legend title is visible.

true: Legend title is visible.

false: Legend title is hidden.

maxXBound

Type: null | number

Description: Maximum bound set for the x-axis. Null indicates no explicit maximum.

minXBound

Type: null | number

Description: Minimum bound set for the x-axis. Null indicates no explicit minimum.

nullCategory

Type: undefined | WebChartNullCategory

Description: The null category configuration of the bar chart.

nullPolicy

Type: undefined | WebChartNullPolicyTypes

Description: Policy which tells the chart how to handle null values.

null: Break the bar where null values are present.

zero: Treats null values as zero.

interpolate: Bar series: same effect as null - Line series: connects the lines across null values.

numericFields

Type: string | string[]

Description: The numeric fields array for the chart.

orderByList

Type: string[]

Description: The list of custom sort values for custom sort

rotatedState

Type: boolean

Description: Whether the chart is rotated.

seriesLength

Type: number

Description: The length of the series array.

splitByField

Type: string

Description: The split-by field for the chart.

splitByValues

Type: string[]

Description: The split-by values for the chart.

stackedType

Type: undefined | WebChartStackedKinds

Description: How the bars/lines should be placed when multiple series are rendered in the same chart, say when "split by" operation is executed on any field or
when multiple attributes/fields corresponding to the same set of classes are to be visualized.

Currently this property is only used for bar and line series.

subtitleSymbol

Type: undefined | WebChartTextSymbol

Description: The subtitle text symbol. Contains styling information such as font, color, and symbol style.

subtitleText

Type: string

Description: The chart subtitle text.

temporalBinningSize

Type: undefined | number

Description: Time interval size for a temporal bar/line chart.

temporalBinningUnit

Type: undefined | WebChartTemporalBinningUnits

Description: Time interval units for a temporal bar/line chart.

timeAggregationType

Type: undefined | WebChartTimeAggregationTypes

Description: Time aggregation type for a temporal bar/line chart.

titleSymbol

Type: undefined | WebChartTextSymbol

Description: The title text symbol. Contains styling information such as font, color, and symbol style.

titleText

Type: string

Description: The chart title text.

trimIncompleteTimeInterval

Type: undefined | boolean

Description: Whether to trim incomplete time intervals for a temporal bar/line chart.

version

Type: undefined | string

Description: The version of the chart configuration.

xAxisField

Type: string

Description: The x-axis field for the chart.

xAxisTitleSymbol

Type: undefined | WebChartTextSymbol

Description: X-axis title text symbol (font, color, style).

xAxisTitleText

Type: string

Description: The x-axis title text.

xAxisTitleVisibility

Type: boolean

Description: Whether the x-axis title is visible.
true: X-axis title is visible.
false: X-axis title is hidden.

Methods

addXAxisGuide

Signature: addXAxisGuide(name: string, index: number): void

Description: Adds an X-axis guide.

Parameters:

  • name: string – The name of the guide.
  • Optional index: number – The index to insert the new guide in the list of X-axis guides. If left undefined, the guide is appended to the end of the list.

Returns: void

addYAxisGuide

Signature: addYAxisGuide(name: string, index: number): void

Description: Adds a Y-axis guide.

Parameters:

  • name: string – The name of the guide.
  • Optional index: number – The index to insert the new guide in the list of Y-axis guides. If left undefined, the guide is appended to the end of the list.

Returns: void

deleteXAxisGuide

Signature: deleteXAxisGuide(index: number): void

Description: Deletes an X-axis guide.

Parameters:

  • Optional index: number – The index of the guide to delete in the list of X-axis guides. If left undefined, the last guide in the list is deleted.

Returns: void

deleteYAxisGuide

Signature: deleteYAxisGuide(index: number): void

Description: Deletes a Y-axis guide.

Parameters:

  • Optional index: number – The index of the guide to delete in the list of Y-axis guides. If left undefined, the last guide in the list is deleted.

Returns: void

generateChartTitle

Signature: generateChartTitle(): string

Description: Generate the proper chart title given the current config.

Returns: string

generateXAxisTitle

Signature: generateXAxisTitle(): string

Description: Generate the proper x-axis title given the current config.

Returns: string

generateYAxisTitle

Signature: generateYAxisTitle(): string

Description: Generate the proper y-axis title given the current config.

Returns: string

getAssignToSecondValueAxis

Signature: getAssignToSecondValueAxis(seriesIndex: number): boolean

Description: Gets whether the series should be assigned to the second value axis.

Parameters:

  • seriesIndex: number – The index of the series.

Returns: boolean

getAxisScrollbar

Signature: getAxisScrollbar(axisIndex: number): undefined | WebChartAxisScrollBar

Description: Gets the scrollbar configuration for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: undefined | WebChartAxisScrollBar

getAxisTitleSymbol

Signature: getAxisTitleSymbol(axisIndex: number): undefined | WebChartTextSymbol

Description: Gets the specified title text symbol. Contains styling information such as font, color, and symbol style.

Parameters:

  • axisIndex: number – No description.

Returns: undefined | WebChartTextSymbol

getAxisTitleText

Signature: getAxisTitleText(axisIndex: number): string

Description: Gets the title text of the specified axis.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: string

getAxisTitleVisibility

Signature: getAxisTitleVisibility(axisIndex: number): boolean

Description: Gets the visibility of the specified axis title.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: boolean

getAxisValueFormat

Signature: getAxisValueFormat(axisIndex: number): undefined | NumberFormatOptions | DateTimeFormatOptions | CategoryFormatOptions

Description: Gets the value format for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: undefined | NumberFormatOptions | DateTimeFormatOptions | CategoryFormatOptions

getBuffer

Signature: getBuffer(axisIndex: number): boolean

Description: Gets the buffer setting for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis

Returns: boolean

getCustomSortValues

Signature: getCustomSortValues(): Promise

Description: Gets the list of the category values for the chart.

Returns: Promise

Async: This method is async and must be awaited.

getDataFilters

Signature: getDataFilters(): undefined | WebChartDataFilters

Description: Gets the data filter for the bar chart.

Returns: undefined | WebChartDataFilters

getDataTooltipReverseColor

Signature: getDataTooltipReverseColor(seriesIndex: number): boolean

Description: Gets the setting of the dataTooltipReverseColor property.

Parameters:

  • Optional seriesIndex: number – The index of the series.

Returns: boolean

getDataTooltipValueFormat

Signature: getDataTooltipValueFormat(seriesIndex: number): undefined | NumberFormatOptions

Description: Gets the data tooltip value format for a series.

If the series index is out of bounds or the series list is empty, this function will return undefined.

Parameters:

  • seriesIndex: number – The index of the series to retrieve the value format for.

Returns: undefined | NumberFormatOptions

getDataTooltipVisibility

Signature: getDataTooltipVisibility(seriesIndex: number): boolean

Description: Gets the visibility of the data tooltips.

Parameters:

  • Optional seriesIndex: number – The index of the series.

Returns: boolean

getDefaultXAxisTitleText

Signature: getDefaultXAxisTitleText(): Promise

Description: Get the default x-axis title text.

Returns: Promise

Async: This method is async and must be awaited.

getDisplayCursorTooltip

Signature: getDisplayCursorTooltip(axisIndex: number): boolean

Description: Gets the display cursor tooltip setting for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis to get the display cursor tooltip for.

Returns: boolean

getDisplayZeroLine

Signature: getDisplayZeroLine(axisIndex: number): boolean

Description: Gets the display zero line setting for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis to get the display zero line for.

Returns: boolean

getGridLinesSymbol

Signature: getGridLinesSymbol(): undefined | ISimpleLineSymbol

Description: Gets the grid lines symbol. Contains styling information such as line width, line style, and line color.

Returns: undefined | ISimpleLineSymbol

getGuideAbove

Signature: getGuideAbove(index: number, orientation: GuideOrientation): boolean

Description: Gets whether the guide should be rendered above the other chart elements.

Parameters:

  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: boolean

getGuideEnd

Signature: getGuideEnd(index: number, orientation: GuideOrientation): undefined | null | string | number | Date

Description: Gets the end value of a guide.

Parameters:

  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: undefined | null | string | number | Date

getGuideLabelText

Signature: getGuideLabelText(index: number, orientation: GuideOrientation): undefined | string

Description: Gets the guide label text.

Parameters:

  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: undefined | string

getGuideName

Signature: getGuideName(index: number, orientation: GuideOrientation): undefined | string

Description: Gets the name of a guide.

Parameters:

  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: undefined | string

getGuideStart

Signature: getGuideStart(index: number, orientation: GuideOrientation): null | string | number | Date

Description: Gets the start value of a guide.

Parameters:

  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: null | string | number | Date

getGuideStyle

Signature: getGuideStyle(index: number, orientation: GuideOrientation): undefined | ISimpleLineSymbol | ISimpleFillSymbol

Description: Gets the guide style.

Parameters:

  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: undefined | ISimpleLineSymbol | ISimpleFillSymbol

getGuideVisibility

Signature: getGuideVisibility(index: number, orientation: GuideOrientation): boolean

Description: Gets whether a guide is visible.

Parameters:

  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: boolean

getHorizontalAxisLabelsBehavior

Signature: getHorizontalAxisLabelsBehavior(): WebChartLabelBehavior

Description: Gets the horizontal axis labels behavior for the chart.

Returns: WebChartLabelBehavior

getIntegerOnlyValues

Signature: getIntegerOnlyValues(axisIndex: number): boolean

Description: Gets the integer only values setting for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis

Returns: boolean

getLogarithmic

Signature: getLogarithmic(axisIndex: number): boolean

Description: Gets whether logarithmic scale is enabled for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

    true: Logarithmic scale is enabled for the specified axis.

    false: Logarithmic scale is disabled for the specified axis.

Returns: boolean

getMaxBound

Signature: getMaxBound(axisIndex: number): number

Description: Gets the maximum bound for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: number

getMinBound

Signature: getMinBound(axisIndex: number): number

Description: Gets the minimum bound for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: number

getOrderOfSeries

Signature: getOrderOfSeries(): string[]

Description: Gets the order of the series array by returning an array of series ids.

Returns: string[]

getSeriesColor

Signature: getSeriesColor(seriesIndex: number): undefined | Color

Description: Gets the color of the series based on the series index. If the index is out of bounds, it will return undefined.

Parameters:

  • seriesIndex: number – The index of the series.

Returns: undefined | Color

getSeriesHideOversizedSideBySideLabels

Signature: getSeriesHideOversizedSideBySideLabels(seriesIndex: number): undefined | boolean

Description: Gets whether to hide oversized data labels of the side-by-side series based on the series index. If the index is out of bounds, it will return undefined.

Parameters:

  • seriesIndex: number – The index of the series.

Returns: undefined | boolean

getSeriesHideOversizedStackedLabels

Signature: getSeriesHideOversizedStackedLabels(seriesIndex: number): undefined | boolean

Description: Gets whether to hide oversized stacked labels of the series based on the series index. If the index is out of bounds, it will return undefined.

Parameters:

  • seriesIndex: number – The index of the series.

Returns: undefined | boolean

getSeriesId

Signature: getSeriesId(seriesIndex: number): undefined | string

Description: Gets the series ID for a given series index.

If the series index is out of bounds, this function will return undefined.

Parameters:

  • seriesIndex: number – The index of the series.

Returns: undefined | string

getSeriesIndex

Signature: getSeriesIndex(seriesId: string): undefined | number

Description: Gets the series index for a given series ID.

If the series ID is not found, this function will return undefined.

Parameters:

  • seriesId: string – No description.

Returns: undefined | number

getSeriesName

Signature: getSeriesName(seriesIndex: number): undefined | string

Description: Gets the name of the series based on the series index.
If the index is out of bounds, it will return undefined.

Parameters:

  • seriesIndex: number – The index of the series.

Returns: undefined | string

getSeriesVisibility

Signature: getSeriesVisibility(seriesIndex: number): boolean

Description: Gets the visibility of a series.

Parameters:

  • seriesIndex: number – The series index

Returns: boolean

getSortOrder

Signature: getSortOrder(): SerialChartDataSortingKinds

Description: Gets the sort order for the bar chart.

Returns: SerialChartDataSortingKinds

getTickSpacing

Signature: getTickSpacing(axisIndex: number): undefined | number

Description: Gets the tick spacing setting for the specified axis.

Parameters:

  • axisIndex: number – The index of the axis

Returns: undefined | number

getTooltipReverseColor

Signature: getTooltipReverseColor(index: number, orientation: GuideOrientation): boolean

Description: Gets whether the tooltip text color should be reversed for a guide.

Parameters:

  • index: number – The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – The axis orientation of the guide.

Returns: boolean

getVerticalAxisLabelsBehavior

Signature: getVerticalAxisLabelsBehavior(): WebChartLabelBehavior

Description: Gets the vertical axis labels behavior for the chart.

Returns: WebChartLabelBehavior

getXGuidesLength

Signature: getXGuidesLength(): undefined | number

Description: Gets the number guides in the X-axis guides list.

Returns: undefined | number

getYGuidesLength

Signature: getYGuidesLength(): undefined | number

Description: Gets the number guides in the Y-axis guides list.

Returns: undefined | number

isSameChartAs

Signature: isSameChartAs(otherModel: undefined | ChartModel): boolean

Description: Checks if the current chart model is for the same chart as another chart model.

Parameters:

  • otherModel: undefined | ChartModel – The other chart model to compare to.

Returns: boolean

moveCustomSortValuesInOrderByList

Signature: moveCustomSortValuesInOrderByList(fromIndex: number, toIndex: number): void

Description: Moves the custom sort values in-place for the order by list in the config.
Note: This method should be only used when the sort order is set to SerialChartDataSortingKinds.customSort.

Parameters:

  • fromIndex: number – The index to move the custom sort value from.
  • toIndex: number – The index to move the custom sort value to.

Returns: void

moveSeries

Signature: moveSeries(fromIndex: number, toIndex: number): void

Description: Moves a series from one index in the series array to another.

Parameters:

  • fromIndex: number – Index to move the series from.
  • toIndex: number – Index to move the series to.

Returns: void

resetAvailable

Signature: resetAvailable(): boolean

Description: Returns whether the series styling is able to be reset.

Returns: boolean

resetSeriesStyling

Signature: resetSeriesStyling(): void

Description: Resets the series styling to the default styling.

Returns: void

resetTimeInterval

Signature: resetTimeInterval(): void

Description: Resets the time interval to default for a temporal line chart.

Returns: void

setAssignToSecondValueAxis

Signature: setAssignToSecondValueAxis(assign: boolean, seriesIndex: number): void

Description: Sets whether the series should be assigned to the second value axis.

Parameters:

  • assign: boolean – The value for the setting.
  • seriesIndex: number – The index of the series.

Returns: void

setAxisScrollbar

Signature: setAxisScrollbar(scrollbar: WebChartAxisScrollBar, axisIndex: number): void

Description: Sets the scrollbar configuration for the specified axis.
Note: The scrollbar configuration for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • scrollbar: WebChartAxisScrollBar – The scrollbar configuration to set.
  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: void

setAxisTitleSymbol

Signature: setAxisTitleSymbol(titleSymbol: undefined | WebChartTextSymbol, axisIndex: number): void

Description: Sets the title text symbol for the specified axis. Contains styling information such as font, color, and symbol style.
Note: The title text symbol for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • titleSymbol: undefined | WebChartTextSymbol – The title text symbol to set.
  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: void

setAxisTitleText

Signature: setAxisTitleText(titleText: string, axisIndex: number): void

Description: Sets the title text for the specified axis.
Note: The title text for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • titleText: string – The title text for the axis.
  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: void

setAxisTitleVisibility

Signature: setAxisTitleVisibility(isVisible: boolean, axisIndex: number): void

Description: Sets the visibility of the specified axis title.
Note: The title visibility for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • isVisible: boolean – The visibility state for the axis title.
  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: void

setAxisValueFormat

Signature: setAxisValueFormat(axisIndex: number, valueFormat: NumberFormatOptions | DateTimeFormatOptions | CategoryFormatOptions): void

Description: Sets the value format for the specified axis.
Note: The value format for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).
  • Optional valueFormat: NumberFormatOptions | DateTimeFormatOptions | CategoryFormatOptions – The value format to set.

Returns: void

setBuffer

Signature: setBuffer(buffer: boolean, axisIndex: number): void

Description: Sets the buffer for the specified axis.

Parameters:

  • buffer: boolean – The setting for the buffer
  • axisIndex: number – The index of the axis

Returns: void

setDataFilters

Signature: setDataFilters(newDataFilter: undefined | WebChartDataFilters): Promise

Description: Sets the data filter for the bar chart.

Parameters:

  • newDataFilter: undefined | WebChartDataFilters – The new data filter.

Returns: Promise

Async: This method is async and must be awaited.

setDataTooltipReverseColor

Signature: setDataTooltipReverseColor(reverseColor: boolean, seriesIndex: number): void

Description: Sets the setting of the dataTooltipReverseColor property.

Parameters:

  • reverseColor: boolean – Indicator of whether to reverse the color.
  • Optional seriesIndex: number – The index of the series to set the reverse color.

Returns: void

setDataTooltipValueFormat

Signature: setDataTooltipValueFormat(seriesIndex: number, valueFormat: undefined | NumberFormatOptions): void

Description: Sets the data tooltip value format for a series.

Parameters:

  • seriesIndex: number – The index of the series to set the value format for.
  • valueFormat: undefined | NumberFormatOptions – The value format to set.

Returns: void

setDataTooltipVisibility

Signature: setDataTooltipVisibility(visibility: boolean, seriesIndex: number): void

Description: Sets the visibility of the data tooltips.

Parameters:

  • visibility: boolean – The visibility of the data tooltips.
  • Optional seriesIndex: number – The index of the series to set the visibility.

Returns: void

setDisplayCursorTooltip

Signature: setDisplayCursorTooltip(displayCursorTooltip: boolean, axisIndex: number): void

Description: Sets the display cursor tooltip setting for the specified axis.

Parameters:

  • displayCursorTooltip: boolean – The display cursor tooltip setting for the axis.
  • axisIndex: number – The index of the axis to set the display cursor tooltip for.

Returns: void

setDisplayZeroLine

Signature: setDisplayZeroLine(displayZeroLine: boolean, axisIndex: number): void

Description: Sets the display zero line setting for the specified axis.

Parameters:

  • displayZeroLine: boolean – The display zero line setting for the axis.
  • axisIndex: number – The index of the axis to set the display zero line for.

Returns: void

setGridLinesSymbol

Signature: setGridLinesSymbol(linesSymbol: undefined | ISimpleLineSymbol, axisIndices: number[]): void

Description: Sets the grid lines symbol. Contains styling information such as line width, line style, and line color.
Note: To set the grid lines symbol for the second Y-axis (axisIndex 2), ensure there is a second Y-axis in the chart by using the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • linesSymbol: undefined | ISimpleLineSymbol – The grid lines symbol.
  • Optional axisIndices: number[] – The indices of the axes to set the grid lines symbol for.

Returns: void

setGuideAbove

Signature: setGuideAbove(above: boolean, index: number, orientation: GuideOrientation): void

Description: Sets whether the guide should be rendered above the other chart elements.

Parameters:

  • above: boolean – New above boolean to set.
  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: void

setGuideEnd

Signature: setGuideEnd(end: undefined | null | string | number | Date, index: number, orientation: GuideOrientation): void

Description: Sets the end value of a guide.

Parameters:

  • end: undefined | null | string | number | Date – New end value to set.
  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: void

setGuideLabelText

Signature: setGuideLabelText(labelText: string, index: number, orientation: GuideOrientation): void

Description: Sets the guide label text.

Parameters:

  • labelText: string – New label text to set.
  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: void

setGuideName

Signature: setGuideName(name: string, index: number, orientation: GuideOrientation): void

Description: Sets the name of a guide.

Parameters:

  • name: string – New name to set.
  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: void

setGuideStart

Signature: setGuideStart(start: null | string | number | Date, index: number, orientation: GuideOrientation): void

Description: Sets the start value of a guide.

Parameters:

  • start: null | string | number | Date – New start value to set.
  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: void

setGuideStyle

Signature: setGuideStyle(style: ISimpleLineSymbol | ISimpleFillSymbol, index: number, orientation: GuideOrientation): void

Description: Sets the guide style.

Parameters:

  • style: ISimpleLineSymbol | ISimpleFillSymbol – New style to set.
  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: void

setGuideVisibility

Signature: setGuideVisibility(visible: boolean, index: number, orientation: GuideOrientation): void

Description: Sets whether a guide is visible

Parameters:

  • visible: boolean – New visibility to set.
  • Optional index: number – Default 0. The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – Default y. The axis orientation of the guide.

Returns: void

setHorizontalAxisLabelsBehavior

Signature: setHorizontalAxisLabelsBehavior(horizontalBehavior: WebChartLabelBehavior): void

Description: Sets the horizontal axis labels behavior for the chart.
Note: The horizontal axis labels behavior for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • horizontalBehavior: WebChartLabelBehavior – The behavior for the horizontal axis labels.

Returns: void

setIntegerOnlyValues

Signature: setIntegerOnlyValues(integerOnlyValues: boolean, axisIndex: number): void

Description: Sets the integer only values setting for the specified axis.

Parameters:

  • integerOnlyValues: boolean – The boolean value to set for the integer only values setting
  • axisIndex: number – The index of the axis

Returns: void

setLogarithmic

Signature: setLogarithmic(isLogarithmic: boolean, axisIndex: number): void

Description: Sets whether logarithmic scale is enabled for the specified axis.
true: Enable logarithmic scale for the specified axis.
false: Disable logarithmic scale for the specified axis.
Note: The logarithmic scale for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • isLogarithmic: boolean – Whether to enable logarithmic scale for the specified axis.
  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: void

setMaxBound

Signature: setMaxBound(newMaxBound: null | number, axisIndex: number): void

Description: Sets the maximum bound for the specified axis.
Note: The maximum bound for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • newMaxBound: null | number – The value to set as the maximum bound.
  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: void

setMinBound

Signature: setMinBound(newMinBound: null | number, axisIndex: number): void

Description: Sets the minimum bound for the specified axis.
Note: The minimum bound for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • newMinBound: null | number – The value to set as the minimum bound.
  • axisIndex: number – The index of the axis (0 for X-axis, 1 for Y-axis, 2 for second Y-axis).

Returns: void

setOrderOfSeries

Signature: setOrderOfSeries(newOrder: string[]): void

Description: Sets the order of the series array by providing an array of series ids.

Parameters:

  • newOrder: string[] – The new order of the series array.

Returns: void

setSeriesColor

Signature: setSeriesColor(newColor: undefined | Color, seriesIndex: number): void

Description: Sets the color of the series based on the series index.

Parameters:

  • newColor: undefined | Color – The new color for the series.
  • seriesIndex: number – The index of the series.

Returns: void

setSeriesHideOversizedSideBySideLabels

Signature: setSeriesHideOversizedSideBySideLabels(hide: undefined | boolean, seriesIndex: number): void

Description: Sets whether to hide oversized data labels of the side-by-side series based on the series index.

Parameters:

  • hide: undefined | boolean – The value for hiding oversized data labels.
  • seriesIndex: number – The index of the series.

Returns: void

setSeriesHideOversizedStackedLabels

Signature: setSeriesHideOversizedStackedLabels(hide: undefined | boolean, seriesIndex: number): void

Description: Sets whether to hide oversized stacked labels of the series based on the series index.

Parameters:

  • hide: undefined | boolean – The value for hiding oversized stacked labels.
  • seriesIndex: number – The index of the series.

Returns: void

setSeriesName

Signature: setSeriesName(name: string, seriesIndex: number): void

Description: Sets name of the series based on the series index.

Parameters:

  • name: string – The name for the series.
  • seriesIndex: number – The index of the series.

Returns: void

setSeriesVisibility

Signature: setSeriesVisibility(props: LegendItemVisibility): void

Description: Sets the visibility of a series.

Parameters:

  • props: LegendItemVisibility – No description.

Returns: void

setSortOrder

Signature: setSortOrder(newSortOrder: SerialChartDataSortingKinds, orderByList: string[]): void

Description: Sets the sort order for the bar chart.

Parameters:

  • newSortOrder: SerialChartDataSortingKinds – The new sort order.
  • Optional orderByList: string[] – The list of category's values to order by.

Returns: void

setTickSpacing

Signature: setTickSpacing(tickSpacing: number, axisIndex: number): void

Description: Sets the tick spacing for the specified axis.

Parameters:

  • tickSpacing: number – The value to set for the tick spacing
  • axisIndex: number – The index of the axis

Returns: void

setTooltipReverseColor

Signature: setTooltipReverseColor(reverseColor: boolean, index: number, orientation: GuideOrientation): void

Description: Sets whether the tooltip text color should be reversed for a guide.

Parameters:

  • reverseColor: boolean – New reverseColor boolean to set.
  • index: number – The index of the guide in the list of guides for the given axis orientation.
  • Optional orientation: GuideOrientation – The axis orientation of the guide.

Returns: void

setup

Signature: setup(params: ModelParams): Promise

Description: Completes the async setup process for the chart model. Must be called before using the model.

Parameters:

  • params: ModelParams – The parameters to be used to set up the chart model.

Returns: Promise

Async: This method is async and must be awaited.

setVerticalAxisLabelsBehavior

Signature: setVerticalAxisLabelsBehavior(verticalBehavior: WebChartLabelBehavior): void

Description: Sets the vertical axis labels behavior for the chart.
Note: The vertical axis labels behavior for the second Y-axis (axisIndex 2) will only be applied if there is a second Y-axis in the chart. To enable the second Y-axis, use the setAssignToSecondValueAxis(true, 1) method to assign a series to the second Y-axis.

Parameters:

  • verticalBehavior: WebChartLabelBehavior – The behavior for the vertical axis labels.

Returns: void

updateSeriesFromLayerFilter

Signature: updateSeriesFromLayerFilter(): Promise

Description: Updates the series based on the layer filter.

Returns: Promise

Async: This method is async and must be awaited.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.