Skip to content

Box Plot 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: ...

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.

boxPlotSeriesIndexWhenMeanLinesShown

Type: number

Description: The index of the box plot series in the series array in config object when show mean is true.
Note: There is only one box plot series when show mean is true. The function returns '-1' if show mean is false.

category

Type: string

Description: The category field for the box plot.

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.

meanLinesBoxColor

Type: undefined | Color

Description: The color of the boxes when showing mean lines. Only applicable when mean lines are shown.

minXBound

Type: null | number

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

numericFields

Type: string | string[]

Description: The numeric fields array for the box plot.

orderByList

Type: string[]

Description: The list of category's values for custom sort

orderOfSeries

Type: string[]

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

rotatedState

Type: boolean

Description: Whether the chart is rotated.

seriesLength

Type: number

Description: The length of the series array.

showMeanLines

Type: undefined | boolean

Description: Whether mean lines are shown.

showOutliers

Type: boolean

Description: Whether outliers are shown.

splitByField

Type: string

Description: The split-by field for the box plot.

splitByValues

Type: string[]

Description: The split-by values for the chart.

standardizeValues

Type: boolean

Description: Whether values are standardized as z-scores.

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.

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.

version

Type: undefined | string

Description: The version of the chart configuration.

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

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

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

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

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

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

getSeriesLineStyle

Signature: getSeriesLineStyle(seriesIndex: number): undefined | RESTSimpleLineSymbolStyle

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

Only applicable when mean lines are shown.

Parameters:

  • seriesIndex: number – The index of the series.

Returns: undefined | RESTSimpleLineSymbolStyle

getSeriesLineWidth

Signature: getSeriesLineWidth(seriesIndex: number): undefined | number

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

Only applicable when mean lines are shown.

Parameters:

  • seriesIndex: number – The index of the series.

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(): BoxPlotDataSortingKinds

Description: Gets the sort order of the box plot data.

Returns: BoxPlotDataSortingKinds

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

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: Move 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 BoxPlotDataSortingKinds.customSort.

Parameters:

  • fromIndex: number – The index to move the custom sort item from.
  • toIndex: number – The index to move the category item 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

resetConfig

Signature: resetConfig(): void

Description: Resets the config to the default config

Returns: void

resetSeriesStyling

Signature: resetSeriesStyling(): void

Description: Resets the series styling to the default styling.

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

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

setSeriesLineStyle

Signature: setSeriesLineStyle(newStyle: undefined | RESTSimpleLineSymbolStyle, seriesIndex: number): void

Description: Sets the line style of the series based on the series index.

Only applicable when mean lines are shown.

Parameters:

  • newStyle: undefined | RESTSimpleLineSymbolStyle – The new style for the series.
  • seriesIndex: number – The index of the series.

Returns: void

setSeriesLineWidth

Signature: setSeriesLineWidth(newWidth: undefined | number, seriesIndex: number): void

Description: Sets the line width of the series based on the series index.

Only applicable when mean lines are shown.

Parameters:

  • newWidth: undefined | number – The new width for the series.
  • seriesIndex: number – The index of the series.

Returns: void

setSeriesName

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

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

Parameters:

  • newName: string – The new 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: BoxPlotDataSortingKinds, orderByList: string[]): void

Description: Sets the sort order of the box plot data.

Parameters:

  • newSortOrder: BoxPlotDataSortingKinds – The new sort order.
  • Optional orderByList: string[] – The new list of category's values for custom sort.

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.