Chart

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

A parsed chart (§21.2): its type, title, categories, series and rendering options.

Properties

barDir?

readonly optional barDir?: "bar" | "col"

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

catAxisLine?

readonly optional catAxisLine?: ChartLineStyle

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

§21.2.2.196 — the category axis’s own rule.

catAxisReversed?

readonly optional catAxisReversed?: boolean

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

§21.2.2.134 c:catAx/c:scaling/c:orientation = maxMin — the category axis runs the other way. A ranked bar chart is written this way so its first row reads at the TOP (dataValidationTableRange.xlsx ranks 38 counties and we printed the ranking upside down).

catAxisTitle?

readonly optional catAxisTitle?: string

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

categoriesRef?

readonly optional categoriesRef?: string

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

§21.2.2.24 c:cat/…/c:f — where the categories live, when uncached.

doughnut?

readonly optional doughnut?: boolean

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

frameFillHex?

readonly optional frameFillHex?: string

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

§21.2.2.198 c:chartSpace/c:spPr — the frame around the whole chart: its background fill and its outline. Excel writes both on every chart it creates, and both references draw them.

frameFillImage?

readonly optional frameFillImage?: object

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

§20.1.8.14 a:blipFill — the PICTURE the frame is filled with, when it is filled with one rather than a colour. chart-texture-bg.pptx papers its whole chart with a woven cloth, and a chart on white is a different chart.

resource

readonly resource: ResourceId

tiled?

readonly optional tiled?: boolean

frameLineDash?

readonly optional frameLineDash?: ShapeDash

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

frameLineHex?

readonly optional frameLineHex?: string

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

frameLineWidthPt?

readonly optional frameLineWidthPt?: number

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

The frame rule’s width and dash, when it states them.

gapPercent?

readonly optional gapPercent?: number

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

§21.2.2.75 c:gapWidth — the gap between category slots as a percentage of the bar width. Absent ⇒ the schema’s 150.

gridLine?

readonly optional gridLine?: ChartLineStyle

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

§21.2.2.87 c:majorGridlines/c:spPr/a:ln — the gridlines’ own rule.

grouping?

readonly optional grouping?: "clustered" | "stacked" | "percentStacked" | "standard"

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

hasLegend

readonly hasLegend: boolean

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

legendPos?

readonly optional legendPos?: "r" | "l" | "t" | "b"

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

lineMarkers?

readonly optional lineMarkers?: boolean

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

§21.2.2.106 c:marker on a c:lineChart — whether the group’s series mark their data points. WithChart.xlsx asks for them and we drew bare lines.

numberFormat?

readonly optional numberFormat?: string

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

§21.2.2.121 c:valAx/c:numFmt@formatCode — the number format the value axis’s tick labels and the data labels are drawn in, in the same code grammar cells use (§18.8.31). Absent ⇒ a plain numeric render.

plotFillHex?

readonly optional plotFillHex?: string

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

§21.2.2.145 c:plotArea/c:spPr — the plot rectangle’s own fill and rule, which sit inside the frame. Chart_Plot_BorderLine_Style.docx rules its plot in a heavy orange dash-dot.

plotLine?

readonly optional plotLine?: ChartLineStyle

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

scatterStyle?

readonly optional scatterStyle?: "line" | "none" | "lineMarker" | "marker" | "smooth" | "smoothMarker"

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

§21.2.2.161 c:scatterStyle — whether a scatter’s points are joined by a line, marked, or both. The schema’s default is marker; Excel writes lineMarker for the chart most people insert.

secondaryValAxisLine?

readonly optional secondaryValAxisLine?: ChartLineStyle

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

§21.2.2.196 — the secondary value axis’s own rule.

secondaryValAxisTitle?

readonly optional secondaryValAxisTitle?: string

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

§21.2.2.168 — the title of the secondary value axis, when one is drawn.

series

readonly series: readonly ChartSeries[]

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

seriesColorCycle?

readonly optional seriesColorCycle?: readonly string[]

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

MS-ODRAWXML chartColorStyle (colorsN.xml): the cycle of series colours; overrides the built-in Office accent cycle when present.

showValues?

readonly optional showValues?: boolean

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

title?

readonly optional title?: string

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

type

readonly type: ChartType

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

valAxisLine?

readonly optional valAxisLine?: ChartLineStyle

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

§21.2.2.196 — the value axis’s own rule.

valAxisMax?

readonly optional valAxisMax?: number

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

valAxisMin?

readonly optional valAxisMin?: number

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

§21.2.2.157 c:valAx/c:scaling/c:min|c:max — the value axis the AUTHOR fixed. Absent means “auto”, and only then is the range read off the data: a chart whose cells all read zero still has the axis its author pinned, and scaling it to the data drew 0…1 where every reader draws 0…300.

valAxisTitle?

readonly optional valAxisTitle?: string

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