Skip to content

Generic chart

A generic chart with full support for ECharts options.

Code

Usage

Required Packages
import { SiChartComponent } from '@siemens/charts-ng';

@Component({
  imports: [SiChartComponent, ...]
})

SiChartComponent API Documentation

selector
si-chart

Input Properties

NameTypeDefaultDescription
additionalOptions
EChartOptionUsed to override specific properties set in options .
autoZoomSeriesIndex
number-1No auto dataZoom update) by default. Use together with visibleEntries .
axisPointer
(undefined | string | boolean)falseUsed to display axisPointer line either by click or mouse-move.
customLegendAction
booleanEnable custom legend click actions exposed by the selectionChanged event.
dataZoomFilterMode
FilterMode'none'The data zoom filter mode. (see https://echarts.apache.org/en/option.html#dataZoom-inside.filterMode )

The value 'filter' will cause the lines to be disconnected to the outside of the chart.
dataZoomMaxValueSpan
numberThe upper limit of the data zoom slider (see https://echarts.apache.org/en/option.html#dataZoom-slider.maxValueSpan ).
dataZoomMinValueSpan
numberThe lower limit of the data zoom slider (see https://echarts.apache.org/en/option.html#dataZoom-slider.minValueSpan ).
dataZoomRange
DataZoomRangeApply a specific zoom range (see https://echarts.apache.org/en/option.html#dataZoom-inside ).
eChartContainerHeight
(null | string)The height of the ECharts container as decimal.
externalXAxisFormatter
(value: any, visibleRange: number) => stringExternal XAxis Formatter from consumer
externalZoomSlider
booleanfalseFlag to use external zoom slider
maxEntries
number1000Maximum number of series data points shown in the chart.
options
EChartOptionSee [ECharts 5.x Documentation] https://echarts.apache.org/en/option.html for all available options.
palette
stringundefinedThe name of the color palette (if any) of the loaded theme .
renderer
("canvas" | "svg")'canvas'the renderer to use: canvas or svg
selectedItem
SelectedLegendItem{ legendItemName: '' }Specify selected legend item.
showCustomLegend
booleanfalseEnable to show a custom legend. The custom legend offers additional features such as, scroll bar to avoid legend and chart overlapping, Left and right alignment of legends based on y-axis, etc and many more.
showLegend
booleantrueShow Echarts legend
subTitle
stringThe subtitle of the chart.
theme
anyThe desired theme to load.
themeCustomization
anyUsed to override specific options of loaded theme .
title
stringThe title of the chart.
visibleEntries
number-1No auto dataZoom update) by default. Use together with autoZoomSeriesIndex .
visibleRange
number-1No auto dataZoom update) by default. Use together with autoZoomSeriesIndex .
zoomInside
booleanfalseEnables zooming inside the chart with the mouse wheel/touch.

Whether zooming inside the chart is possible with mouse.
zoomSlider
booleanfalseEnables the zoom slider below the chart.
zoomSliderBrush
booleantrueenable brush mode for zoom slider
zoomSliderRealtime
booleantruerealtime update mode for zoom slider
zoomSliderShadow
booleantrueShows data shadow in dataZoom slider, use together with zoomSlider .
showTimeRangeBar
Deprecated
booleanfalseIf true, add consumer-provided time range bar. Use together with zoomSlider .
Deprecated: The input will be removed in future versions as the time range bar slot is deprecated.

Output Properties

NameTypeDescription
chartGridResized
GridRectCoordinateEvent emitted when chart grid is resized.
chartSeriesClick
LegendItemEvent emitted when a chart series is clicked.
customLegendMultiLineInfoEvent
CustomLegendMultiLineInfo[]Event emitted when custom legend multi-line info changes.
dataZoom
DataZoomEventEvent emitted when data zoom changes.
pointer
AxisPointerEventEvent emitted when axis pointer moves.
selectionChanged
anyEvent emitted when selection changes e.g. clicking on a legend item.
showLegendChange
booleanShow Echarts legend
timeRangeChange
numberEmitted when data zoom changes, indicating the time range in milliseconds, 0 for full range
visibleEntriesChange
numberNo auto dataZoom update) by default. Use together with autoZoomSeriesIndex .
visibleRangeChange
numberNo auto dataZoom update) by default. Use together with autoZoomSeriesIndex .

Attributes and Methods

NameTypeDefaultDescription
startProgressIndication()
() => voidShow loading indicator.
stopProgressIndication()
() => voidHide loading indicator.

Types Documentation

Index signature: [ key: string ]: any
Properties
dataZoom?: DataZoomComponentOption[]
grid?: (GridComponentOption | GridComponentOption[])
legend?: LegendComponentOption[]
series?: EChartSeries
("none" | "filter" | "weakFilter" | "empty")
Properties
end?: any
endValue?: any
start?: any
startValue?: any
visibleWidth?: any
Properties
legendItemName: string
Properties
containerHeight: number
containerWidth: number
height: number
width: number
x: number
y: number
Properties
color?: string
dataIndex: number
itemName: string
selected?: boolean
Properties
customLegendId: number
isCustomLegendMultilined: boolean
Properties
autoZoomUpdate?: boolean
rangeEnd: any
rangeStart: any
rangeType: AxisType
requested?: DataZoomRange
source?: string
width?: number
Properties
dataIndex?: number
seriesIndex?: number
Properties
backgroundColor?: ZRColor
borderColor?: ZRColor
borderWidth?: number
bottom?: PositionSizeOption from BoxLayoutOptionMixin.bottom
Deprecated: Use grid.outerBounds instead. Whether grid size contains axis labels. This approach estimates the size by sample labels. It works for most case but it does not strictly contain all labels in some cases.
containLabel?: boolean
coord?: CoordinateSystemDataCoord from ComponentOption.coord
coordinateSystem?: string from ComponentOption.coordinateSystem
coordinateSystemUsage?: CoordinateSystemUsageOption from ComponentOption.coordinateSystemUsage
height?: PositionSizeOption from BoxLayoutOptionMixin.height
id?: OptionId from ComponentOption.id
left?: PositionSizeOption from BoxLayoutOptionMixin.left
mainType?: "grid"
name?: OptionName from ComponentOption.name
{left, right, top, bottom, width, height}: Define a outerBounds rect, based on: - the canvas by default. - or the dataToLayout result if a boxCoordinateSystem is specified.
outerBounds?: BoxLayoutOptionMixin
outerBoundsClampHeight?: (string | number)
Available only when outerBoundsMode is not 'none'. Offer a constraint to not to shrink the grid rect causing smaller that width/height. A string means percent, like '30%', based on the original rect size determined by grid.top/right/bottom/left/width/height .
outerBoundsClampWidth?: (string | number)
- 'all': Default. Contains the cartesian rect and axis labels and axis name. - 'axisLabel': Contains the cartesian rect and axis labels. This effect differs slightly from the previous option containLabel but more precise. - 'auto'/null/undefined: Default. be 'axisLabel' if containLabel:true , otherwise 'all'.
outerBoundsContain?: ("all" | "auto" | "axisLabel" | NullUndefined$1)
Define a constrains rect. Axis lines is firstly laid out based on the rect defined by grid.left/right/top/bottom/width/height . (for axis line alignment requirements between multiple grids) But if axisLabel and/or axisName overflow the outerBounds, shrink the layout to avoid that overflow.

Options: - 'none': outerBounds is infinity. - 'same': outerBounds is the same as the layout rect defined by grid.left/right/top/bottom/width/height . - 'auto'/null/undefined: Default. Use outerBounds , or 'same' if containLabel:true .

Note: grid.containLabel is equivalent to {outerBoundsMode: 'same', outerBoundsContain: 'axisLabel'} .

outerBoundsMode?: ("auto" | "none" | "same" | NullUndefined$1)
right?: PositionSizeOption from BoxLayoutOptionMixin.right
shadowBlur?: number from ShadowOptionMixin.shadowBlur
shadowColor?: string from ShadowOptionMixin.shadowColor
shadowOffsetX?: number from ShadowOptionMixin.shadowOffsetX
shadowOffsetY?: number from ShadowOptionMixin.shadowOffsetY
show?: boolean
tooltip?: any
top?: PositionSizeOption from BoxLayoutOptionMixin.top
type?: string from ComponentOption.type
width?: PositionSizeOption from BoxLayoutOptionMixin.width
z?: number from ComponentOption.z
zlevel?: number from ComponentOption.zlevel
("value" | "category" | "time" | "log")
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
import
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts
imported from echarts

Except where otherwise noted, content on this site is licensed under MIT License.