Skip to content

Class: ChartExSeries ​

One data series (cx:series) of a chartEx chart.

Constructors ​

Constructor ​

new ChartExSeries(ser, chart): ChartExSeries

Parameters ​

ParameterType
serElement
chartChartEx

Returns ​

ChartExSeries

Accessors ​

categories ​

Get Signature ​

get categories(): (string | null)[]

Cached category labels (cx:strDim's leaf cx:lvl — the first level, which the writer emits leaf-first). Empty when the data block carries no cx:strDim.

Returns ​

(string | null)[]


dataId ​

Get Signature ​

get dataId(): number | null

The data-block id this series plots (cx:dataId/@val), or null.

Returns ​

number | null


dataLabels ​

Get Signature ​

get dataLabels(): ChartExDataLabels | null

The data-label toggles (cx:dataLabels), or null when the series shows none.

Returns ​

ChartExDataLabels | null


element_ ​

Get Signature ​

get element_(): Element

Escape hatch: the underlying cx:series element. After mutating it call markDirty, or save() writes the original bytes.

Returns ​

Element


layoutId ​

Get Signature ​

get layoutId(): string | null

The layout token (@layoutId) that keys this series' geometry, e.g. waterfall.

Returns ​

string | null


name ​

Get Signature ​

get name(): string | null

Series name from the cached cx:tx/cx:txData/cx:v, or null when unnamed.

Returns ​

string | null


ownerIndex ​

Get Signature ​

get ownerIndex(): number | null

The owner series index (@ownerIdx) for a derived series (a paretoLine derives its data from series 0), or null for a self-contained series.

Returns ​

number | null


uniqueId ​

Get Signature ​

get uniqueId(): string | null

The deterministic series GUID (@uniqueId), or null.

Returns ​

string | null


values ​

Get Signature ​

get values(): (number | null)[]

Cached numeric values (cx:numDim); non-numeric or missing points are null.

Returns ​

(number | null)[]

Methods ​

markDirty() ​

markDirty(): void

Mark the owning chartEx part dirty so save() reserializes it. Call after mutating element_.

Returns ​

void