ChartSeries

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

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

Properties

colorHex?

readonly optional colorHex?: string

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

---

line?

readonly optional line?: ChartLineStyle

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

§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.

---

marker?

readonly optional marker?: ChartMarker

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

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

---

name?

readonly optional name?: string

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

---

nameRef?

readonly optional nameRef?: string

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

---

pointColors?

readonly optional pointColors?: readonly ChartDataPoint[]

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

---

pointLabels?

readonly optional pointLabels?: readonly object[]

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

§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.

---

secondaryAxis?

readonly optional secondaryAxis?: boolean

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

§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.

---

type?

readonly optional type?: ChartType

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

§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.

---

values

readonly values: readonly number[]

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

---

valuesRef?

readonly optional valuesRef?: string

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

§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.

---

xValues?

readonly optional xValues?: readonly number[]

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