Skip to content

ChartSeries

Defined in: src/core/document-model/types.ts:1586

One chart data series (c:ser): its name, values and colour overrides.

readonly optional colorHex?: string

Defined in: src/core/document-model/types.ts:1606


readonly optional explosion?: number

Defined in: src/core/document-model/types.ts:1613

§21.2.2.61 c:explosion — how far a pie’s slices stand out from its centre, as a percentage of its radius: the series’ own, and each point’s (c:dPt/c:explosion) over it.


readonly optional line?: ChartLineStyle

Defined in: src/core/document-model/types.ts:1656

§21.2.2.198 c:ser/c:spPr/a:ln — the series’ OWN rule. <a:noFill/> is how Excel writes “scatter with markers only”: the group still says lineMarker, and it is this line that says the points are not joined. SimpleScatterChart.xlsx is two loose dots in both references and we ran a line between them.


readonly optional marker?: ChartMarker

Defined in: src/core/document-model/types.ts:1648

§21.2.2.106 c:marker — the symbol this series stamps on each of its points. Absent ⇒ the reader’s own default.


readonly optional name?: string

Defined in: src/core/document-model/types.ts:1587


readonly optional nameRef?: string

Defined in: src/core/document-model/types.ts:1643


readonly optional pointColors?: readonly ChartDataPoint[]

Defined in: src/core/document-model/types.ts:1607


readonly optional pointExplosions?: readonly object[]

Defined in: src/core/document-model/types.ts:1614


readonly optional pointLabelPlacements?: readonly object[]

Defined in: src/core/document-model/types.ts:1629

§21.2.2.47 c:dLbl — where one point’s label stands, when the point says: its own c:dLblPos, and the c:layout/c:manualLayout it was dragged to — x and y fractions of the chart, the label’s own top-left corner where edge, else how far it moved from where the chart would set it.


readonly optional pointLabels?: readonly object[]

Defined in: src/core/document-model/types.ts:1622

§21.2.2.49 c:dLbl/c:tx — a data label the author typed rather than one the chart computes, by point index. Excel and Calc print it verbatim: it is the only place a label like “Промышленные потребители; 22,7млрд.кВтч; 67,3%” exists, and generating one from the value instead loses the whole sentence.


readonly optional secondaryAxis?: boolean

Defined in: src/core/document-model/types.ts:1603

§21.2.2.9 c:axId — the series plots against the SECONDARY value axis: its group names a c:valAx other than the one the first group uses. 57362.xlsx puts its line on an axis of its own at axPos="r", and plotting it on the primary scale puts every point at the wrong height whenever the two ranges differ.


readonly optional type?: ChartType

Defined in: src/core/document-model/types.ts:1595

§21.2.2 — the chart group this series came from, when it is NOT the group that gave Chart.type. A c:plotArea may hold several groups: a combo chart writes c:barChart and c:lineChart side by side, and reading only the first drops the other’s series off the page entirely (57362.xlsx loses its line). Absent ⇒ the series draws as the chart’s own type.


readonly values: readonly number[]

Defined in: src/core/document-model/types.ts:1604


readonly optional valuesRef?: string

Defined in: src/core/document-model/types.ts:1642

§21.2.2.59 c:val/c:numRef/c:f and §21.2.2.215 c:tx/c:strRef/c:f — where the series reads its numbers and its name FROM, when the chart part carries no cache of them. A chart written without caches is not a chart without data: the reader resolves these against the workbook.


readonly optional xValues?: readonly number[]

Defined in: src/core/document-model/types.ts:1605