ts-pptx

Appearance

Interface: ChartOpts ​

Options for the modern (Office 2016) chartEx chart types.

NOTE: chartEx charts (currently waterfall) render only in PowerPoint 2016+/Microsoft 365. In older Office, Google Slides, Keynote and LibreOffice a fallback placeholder shows instead.

Extends ​

Properties ​

align? ​

optional align?: HAlign

Horizontal alignment

When a shape's text is an array of runs, set this on every run of a paragraph. breakLine is not the only paragraph boundary: two adjacent runs whose align differs start a new one, so stating it on the opening run alone splits the paragraph in two. That is the mirror of bullet, paraMarginLeft and paraIndent, which are read from the opening run only. Neither mistake changes the run count — the only symptom is a differently shaped paragraph, with no error.

Default ​

ts
'left'

Inherited from ​

ChartPropsTitle.align

altText? ​

optional altText?: string

Alt Text value ("How would you describe this object and its contents to someone who is blind?")

  • PowerPoint: [right-click on a chart] > "Edit Alt Text..."

Overrides ​

ObjectNameProps.altText

bar3DShape? ​

optional bar3DShape?: "cone" | "coneToMax" | "box" | "cylinder" | "pyramid" | "pyramidToMax"

The solid a 3-D bar is drawn as (ST_Shape).

Default ​

ts
'box'

Inherited from ​

ChartPropsChartBar.bar3DShape

barDir? ​

optional barDir?: "col" | "bar"

Whether bars run horizontally (bar) or vertically (col) (ST_BarDir).

Default ​

ts
'col'

Inherited from ​

ChartPropsChartBar.barDir

barGapDepthPct? ​

optional barGapDepthPct?: number

Inherited from ​

ChartPropsChartBar.barGapDepthPct

barGapWidthPct? ​

optional barGapWidthPct?: number

MS-PPT > Format chart > Format Data Point > Series Options > "Gap Width"

  • width (percent)
  • range: 0-500

Default ​

ts
150

Inherited from ​

ChartPropsChartBar.barGapWidthPct

barGrouping? ​

optional barGrouping?: "standard" | "percentStacked" | "clustered" | "stacked"

How the plot stacks its series (ST_BarGrouping). A 2-D bar plot takes every member but standard, which is the 3-D form's own default; an out-of-range value falls back to the default for the plot with a warning.

Default ​

ts
'clustered' (2-D), 'standard' (3-D)

Inherited from ​

ChartPropsChartBar.barGrouping

barOverlapPct? ​

optional barOverlapPct?: number

MS-PPT > Format chart > Format Data Point > Series Options > "Series Overlap"

  • overlap (percent)
  • range: -100-100

Default ​

ts
0

Inherited from ​

ChartPropsChartBar.barOverlapPct

barSeriesLine? ​

optional barSeriesLine?: boolean | OptsChartGridLine

Draw connector lines between data points across stacked bar/column series ("Series Lines" in PowerPoint). Emits <c:serLines> in the bar chart.

  • true uses PowerPoint's automatic line styling.
  • An OptsChartGridLine object customizes color/size/style/cap.
  • Omit (or pass an object with style: 'none') to disable.

Bar (bar) charts only; ignored for 3D bar charts.

Default ​

ts
undefined

Examples ​

ts
true
ts
{ color: '777777', size: 1, style: 'dash' }

Inherited from ​

ChartPropsChartBar.barSeriesLine

binning? ​

optional binning?: ChartExBinning

Bin configuration for a histogram chart. Omit for PowerPoint's automatic binning.

Example ​

ts
{ intervalClosed: 'l' }

Inherited from ​

ChartPropsChartHistogram.binning

bold? ​

optional bold?: boolean

Bold style

Default ​

ts
false

Inherited from ​

ChartPropsTitle.bold

breakLine? ​

optional breakLine?: boolean

Add a line-break

Default ​

ts
false

Inherited from ​

ChartPropsTitle.breakLine

bullet? ​

optional bullet?: boolean | "inherit" | TextBulletProps

Add standard or custom bullet

  • use true for standard bullet
  • pass object options for custom bullet
  • false (and omitting the option) is the explicit off: it writes <a:buNone/> plus marL="0" indent="0", which overrides whatever bullet the layout's or master's list style sets for this level
  • 'inherit' states nothing at all — no bullet child and no margin attributes — so the list style keeps reaching the paragraph. This is the one state omission cannot spell, because omitting the option means false here for compatibility

The margins are only a default of the bullet state: paraMarginLeft and paraIndent state @marL/@indent independently in any of the three, including an inherited margin under a drawn bullet.

When a shape's text is an array of runs, state this on the opening run only. A run that draws a bullet starts a new paragraph by itself, so repeating it — the placement that align requires — turns one three-run paragraph into three one-run paragraphs. A paragraph takes its properties from its first run.

Default ​

ts
false

Inherited from ​

ChartPropsTitle.bullet

caps? ​

optional caps?: "small" | "all" | "none"

Text capitalization (a:rPr/@cap, ST_TextCapsType)

  • 'all' = ALL CAPS
  • 'small' = Small Caps
  • 'none' = the explicit off: it writes cap="none", which overrides a capitalization the run would otherwise inherit. Omitting the option states nothing and lets that inheritance stand
  • PowerPoint: Font > Effects > All Caps / Small Caps

Default ​

ts
(unset) inherit

Inherited from ​

ChartPropsTitle.caps

catAxes? ​

optional catAxes?: ChartPropsAxisCat[]

Multi-Chart prop: array of cat axes

Inherited from ​

ChartPropsAxisCat.catAxes

catAxisBaseTimeUnit? ​

optional catAxisBaseTimeUnit?: "years" | "months" | "days"

The unit a date axis counts from in (c:baseTimeUnit/@val, ST_TimeUnit).

The canonical spelling is lower-case, and the check forgives case at run time, so 'Days' is taken as days. The type names the canonical three so the call site offers them; do not read the narrower type as permission to drop the tolerance, which a JavaScript caller with no types still relies on. Anything else warns chart/invalid-axis-time-unit and leaves the element off, because a garbage unit makes PowerPoint render nothing at all.

Inherited from ​

ChartPropsAxisCat.catAxisBaseTimeUnit

catAxisCrossesAt? ​

optional catAxisCrossesAt?: number | "autoZero"

Inherited from ​

ChartPropsAxisCat.catAxisCrossesAt

catAxisHidden? ​

optional catAxisHidden?: boolean

Inherited from ​

ChartPropsAxisCat.catAxisHidden

catAxisLabelColor? ​

optional catAxisLabelColor?: string

Inherited from ​

ChartPropsAxisCat.catAxisLabelColor

catAxisLabelFontBold? ​

optional catAxisLabelFontBold?: boolean

Inherited from ​

ChartPropsAxisCat.catAxisLabelFontBold

catAxisLabelFontFace? ​

optional catAxisLabelFontFace?: string

Inherited from ​

ChartPropsAxisCat.catAxisLabelFontFace

catAxisLabelFontItalic? ​

optional catAxisLabelFontItalic?: boolean

Inherited from ​

ChartPropsAxisCat.catAxisLabelFontItalic

catAxisLabelFontSize? ​

optional catAxisLabelFontSize?: number

Inherited from ​

ChartPropsAxisCat.catAxisLabelFontSize

catAxisLabelFormatCode? ​

optional catAxisLabelFormatCode?: string

Number format code for the category (X) axis labels on scatter and bubble charts. Falls back to valAxisLabelFormatCode when not set.

  • Example: '0.00', '#,##0', 'mmm yyyy'
  • PowerPoint: Format Axis > Number > Format Code

Inherited from ​

ChartPropsAxisCat.catAxisLabelFormatCode

catAxisLabelFrequency? ​

optional catAxisLabelFrequency?: string | number

Show every Nth category label (c:tickLblSkip, ST_Skip), e.g. 2 for every other one.

  • a whole number of at least 1; anything else warns and leaves the element off

Pass a number. The string half is a compatibility hangover — this was typed as a free-form string and emitted verbatim, which both rejected the natural 2 and let 'every other' reach the attribute — and is read with Number() like any other.

Inherited from ​

ChartPropsAxisCat.catAxisLabelFrequency

catAxisLabelPos? ​

optional catAxisLabelPos?: "none" | "high" | "low" | "nextTo"

Inherited from ​

ChartPropsAxisCat.catAxisLabelPos

catAxisLabelRotate? ​

optional catAxisLabelRotate?: number

Inherited from ​

ChartPropsAxisCat.catAxisLabelRotate

catAxisLine? ​

optional catAxisLine?: StrokeProps

The category axis line, as a stroke: width, dashType, type, color, cap and transparency under the same names a table border and a gridline use.

type: 'none' paints no line (an <a:noFill/> on the axis' own <c:spPr>), which is what catAxisLineShow: false used to say. Omitted, the line is drawn at 1 pt in DEF_GRIDLINE_COLOR, solid, flat-capped.

The four flat catAxisLine* keys below are the pre-4.0 spellings. Anything set here wins over its flat counterpart. They cannot express a cap, a transparency, or any dash outside solid/dash/dot, which is why they are superseded rather than widened.

Example ​

ts
{ width: 1.5, dashType: 'lgDashDot', color: SchemeColor.accent1, transparency: 40 }

Inherited from ​

ChartPropsAxisCat.catAxisLine

catAxisLineColor? ​

optional catAxisLineColor?: string

Category-axis line colour.

Deprecated ​

Use catAxisLine.color.

Inherited from ​

ChartPropsAxisCat.catAxisLineColor

catAxisLineShow? ​

optional catAxisLineShow?: boolean

Draw the category-axis line at all.

Deprecated ​

Use catAxisLine.type: 'none' to suppress it.

Default ​

ts
true

Inherited from ​

ChartPropsAxisCat.catAxisLineShow

catAxisLineSize? ​

optional catAxisLineSize?: number

Category-axis line width in points.

Deprecated ​

Use catAxisLine.width.

Inherited from ​

ChartPropsAxisCat.catAxisLineSize

catAxisLineStyle? ​

optional catAxisLineStyle?: "dash" | "solid" | "dot"

Category-axis line dash.

Deprecated ​

Use catAxisLine.dashType, which takes the full ST_PresetLineDashVal set.

Inherited from ​

ChartPropsAxisCat.catAxisLineStyle

catAxisMajorTickMark? ​

optional catAxisMajorTickMark?: "none" | "cross" | "in" | "out"

Inherited from ​

ChartPropsAxisCat.catAxisMajorTickMark

catAxisMajorTimeUnit? ​

optional catAxisMajorTimeUnit?: "years" | "months" | "days"

The unit a date axis counts major tick marks in (c:majorTimeUnit/@val, ST_TimeUnit).

The canonical spelling is lower-case, and the check forgives case at run time, so 'Days' is taken as days. The type names the canonical three so the call site offers them; do not read the narrower type as permission to drop the tolerance, which a JavaScript caller with no types still relies on. Anything else warns chart/invalid-axis-time-unit and leaves the element off, because a garbage unit makes PowerPoint render nothing at all.

Inherited from ​

ChartPropsAxisCat.catAxisMajorTimeUnit

catAxisMajorUnit? ​

optional catAxisMajorUnit?: number

Spacing between major tick marks on a date axis or a scatter's X axis (c:majorUnit, ST_AxisUnit).

  • above 0; anything else warns and leaves the element off

Inherited from ​

ChartPropsAxisCat.catAxisMajorUnit

catAxisMaxVal? ​

optional catAxisMaxVal?: number

Axis maximum (c:max). A value that is not a finite number throws.

Inherited from ​

ChartPropsAxisCat.catAxisMaxVal

catAxisMinorTickMark? ​

optional catAxisMinorTickMark?: "none" | "cross" | "in" | "out"

Inherited from ​

ChartPropsAxisCat.catAxisMinorTickMark

catAxisMinorTimeUnit? ​

optional catAxisMinorTimeUnit?: "years" | "months" | "days"

The unit a date axis counts minor tick marks in (c:minorTimeUnit/@val, ST_TimeUnit).

The canonical spelling is lower-case, and the check forgives case at run time, so 'Days' is taken as days. The type names the canonical three so the call site offers them; do not read the narrower type as permission to drop the tolerance, which a JavaScript caller with no types still relies on. Anything else warns chart/invalid-axis-time-unit and leaves the element off, because a garbage unit makes PowerPoint render nothing at all.

Inherited from ​

ChartPropsAxisCat.catAxisMinorTimeUnit

catAxisMinorUnit? ​

optional catAxisMinorUnit?: number

Spacing between minor tick marks; the same rule as ChartPropsAxisCat.catAxisMajorUnit.

Inherited from ​

ChartPropsAxisCat.catAxisMinorUnit

catAxisMinVal? ​

optional catAxisMinVal?: number

Axis minimum (c:min). A value that is not a finite number throws.

Inherited from ​

ChartPropsAxisCat.catAxisMinVal

catAxisMultiLevelLabels? ​

optional catAxisMultiLevelLabels?: boolean

Inherited from ​

ChartPropsAxisCat.catAxisMultiLevelLabels

catAxisOrientation? ​

optional catAxisOrientation?: "maxMin" | "minMax"

Inherited from ​

ChartPropsAxisCat.catAxisOrientation

catAxisTitle? ​

optional catAxisTitle?: string

Inherited from ​

ChartPropsAxisCat.catAxisTitle

catAxisTitleColor? ​

optional catAxisTitleColor?: string

Inherited from ​

ChartPropsAxisCat.catAxisTitleColor

catAxisTitleFontFace? ​

optional catAxisTitleFontFace?: string

Inherited from ​

ChartPropsAxisCat.catAxisTitleFontFace

catAxisTitleFontSize? ​

optional catAxisTitleFontSize?: number

Inherited from ​

ChartPropsAxisCat.catAxisTitleFontSize

catAxisTitleRotate? ​

optional catAxisTitleRotate?: number

Inherited from ​

ChartPropsAxisCat.catAxisTitleRotate

catGridLine? ​

optional catGridLine?: OptsChartGridLine

Inherited from ​

ChartPropsAxisCat.catGridLine

catLabelFormatCode? ​

optional catLabelFormatCode?: string

Inherited from ​

ChartPropsAxisCat.catLabelFormatCode

chartArea? ​

optional chartArea?: ChartAreaProps

PowerPoint: Format Chart Area (Fill & Border/Line)

Inherited from ​

ChartPropsBase.chartArea

chartColors? ​

optional chartColors?: string[]

Series colours, cycled: series (or, on a pie/doughnut, data point) n takes chartColors[n % chartColors.length], so a shorter list repeats rather than running out.

Omitting it, or passing an empty array, both mean the same thing — the built-in default palette for the chart type. Two spellings of "I named no colours"; there is no third state that suppresses the fills.

Inherited from ​

ChartPropsBase.chartColors

chartColorsOpacity? ​

optional chartColorsOpacity?: number

Series fill opacity, as a percentage from 0 to 100.

0 means what it says: a fully transparent fill, so the series is invisible. That is a deliberate meaning, not a shorthand for "unset"; leave the option out for an opaque fill. A value outside 0-100 clamps with a warning, and NaN throws.

Example ​

ts
50 // 50% opaque

Inherited from ​

ChartPropsBase.chartColorsOpacity

color? ​

optional color?: string

Text color

  • HexColor or ThemeColor
  • MS-PPT > Format Shape > Text Options > Text Fill & Outline > Text Fill > Color

Examples ​

ts
'FF0000' // hex color (red)
ts
SchemeColor.text1 // Theme color (Text1)

Inherited from ​

ChartPropsTitle.color

dataBorder? ​

optional dataBorder?: StrokeProps

Inherited from ​

ChartPropsBase.dataBorder

dataLabelBkgrdColors? ​

optional dataLabelBkgrdColors?: boolean

Inherited from ​

ChartPropsDataLabel.dataLabelBkgrdColors

dataLabelColor? ​

optional dataLabelColor?: string

Inherited from ​

ChartPropsDataLabel.dataLabelColor

dataLabelFontBold? ​

optional dataLabelFontBold?: boolean

Inherited from ​

ChartPropsDataLabel.dataLabelFontBold

dataLabelFontFace? ​

optional dataLabelFontFace?: string

Inherited from ​

ChartPropsDataLabel.dataLabelFontFace

dataLabelFontItalic? ​

optional dataLabelFontItalic?: boolean

Inherited from ​

ChartPropsDataLabel.dataLabelFontItalic

dataLabelFontSize? ​

optional dataLabelFontSize?: number

Inherited from ​

ChartPropsDataLabel.dataLabelFontSize

dataLabelFormatCode? ​

optional dataLabelFormatCode?: string

Data label format code

Examples ​

ts
'#%' // round percent
ts
'0.00%' // shows values as '0.00%'
ts
'$0.00' // shows values as '$0.00'

Inherited from ​

ChartPropsDataLabel.dataLabelFormatCode

dataLabelFormatScatter? ​

optional dataLabelFormatScatter?: "custom" | "customXY" | "XY"

What a scatter's data labels show when ChartPropsBase.showLabel is set. A scatter writes series labels only for one of these, so showLabel alone shows nothing.

  • 'XY': each point's value and category name, composed by PowerPoint;
  • 'custom': each point's label text;
  • 'customXY': each point's label text followed by its X and Y values, for a label that is not blank.

Inherited from ​

ChartPropsDataLabel.dataLabelFormatScatter

dataLabelPosition? ​

optional dataLabelPosition?: "r" | "b" | "ctr" | "t" | "l" | "bestFit" | "inBase" | "inEnd" | "outEnd"

Where a data label sits relative to its point (ST_DLblPos).

The whole set is legal on the attribute, but only a subset of it is legal per plot type -- a pie takes bestFit/ctr/inEnd/outEnd and nothing else, a stacked bar takes inBase and not outEnd. A value outside this plot's subset is dropped with a warning rather than emitted, because PowerPoint reports the file as needing repair.

Inherited from ​

ChartPropsDataLabel.dataLabelPosition

dataNoEffects? ​

optional dataNoEffects?: boolean

Inherited from ​

ChartPropsChartDoughnut.dataNoEffects

dataTableFontSize? ​

optional dataTableFontSize?: number

Inherited from ​

ChartPropsDataTable.dataTableFontSize

dataTableFormatCode? ​

optional dataTableFormatCode?: string

Data table format code

Examples ​

ts
'#%' // round percent
ts
'0.00%' // shows values as '0.00%'
ts
'$0.00' // shows values as '$0.00'

Inherited from ​

ChartPropsDataTable.dataTableFormatCode

displayBlanksAs? ​

optional displayBlanksAs?: "zero" | "gap" | "span"

What a plot draws where a value is missing (ST_DispBlanksAs).

Default ​

ts
'gap'

Inherited from ​

ChartPropsBase.displayBlanksAs

firstSliceAng? ​

optional firstSliceAng?: number

MS-PPT > Format chart > Format Data Series > Series Options > "Angle of first slice"

  • angle (degrees)
  • range: 0-359

Default ​

ts
0

Inherited from ​

ChartPropsChartPie.firstSliceAng

fontFace? ​

optional fontFace?: string

Font face name

Applied to the Latin (<a:latin>) and complex-script (<a:cs>) font slots, matching how PowerPoint writes a font picked from the UI. The East Asian slot (<a:ea>) is left to inherit from the theme unless fontFaceEA is set — forcing a Latin-only face into the East Asian slot duplicates/ghosts text in Office 365.

Example ​

ts
'Arial' // Arial font

Inherited from ​

ChartPropsTitle.fontFace

fontFaceEA? ​

optional fontFaceEA?: string

East Asian font face name (<a:ea> slot), used to render CJK (Chinese/Japanese/Korean) glyphs

Set this when the East Asian font differs from fontFace. When omitted, <a:ea> inherits the theme East Asian font, which is what PowerPoint does for Latin fonts.

Example ​

ts
'微軟正黑體' // render East Asian glyphs with Microsoft JhengHei

Inherited from ​

ChartPropsTitle.fontFaceEA

fontSize? ​

optional fontSize?: number

Font size

Example ​

ts
12 // Font size 12

Inherited from ​

ChartPropsTitle.fontSize

geography? ​

optional geography?: ChartExGeography

Geography configuration for a regionMap chart. Omit for PowerPoint's defaults (cultureLanguage: 'en-US', cultureRegion: 'US').

Example ​

ts
{ cultureLanguage: 'en-US', cultureRegion: 'FR' }

Inherited from ​

ChartPropsChartRegionMap.geography

h? ​

optional h?: Coord

Height

  • inches or percentage

Examples ​

ts
10.25 // height in inches
ts
'75%' // height as percentage of slide size

Inherited from ​

PositionProps.h

highlight? ​

optional highlight?: string

Text highlight color (hex format)

Example ​

ts
'FFFF00' // yellow

Inherited from ​

ChartPropsTitle.highlight

holeSize? ​

optional holeSize?: number

Inherited from ​

ChartPropsChartDoughnut.holeSize

invertedColors? ​

optional invertedColors?: string[]

Inherited from ​

ChartPropsBase.invertedColors

italic? ​

optional italic?: boolean

italic style

Default ​

ts
false

Inherited from ​

ChartPropsTitle.italic

lang? ​

optional lang?: string

language

  • ISO 639-1 standard language code

Default ​

ts
'en-US' // english US

Example ​

ts
'fr-CA' // french Canadian

Inherited from ​

ChartPropsBase.lang

layout? ​

optional layout?: PositionProps

Inherited from ​

ChartPropsBase.layout

leaderLineColor? ​

optional leaderLineColor?: string

Leader line color (pie/doughnut data labels). Requires showLeaderLines: true. When omitted, PowerPoint applies its automatic leader-line color.

Example ​

ts
'FF0000' // red leader lines

Inherited from ​

ChartPropsBase.leaderLineColor

leaderLineSize? ​

optional leaderLineSize?: number

Leader line width, in points (pie/doughnut data labels). Requires showLeaderLines: true.

Default ​

ts
0.75

Example ​

ts
1.5

Inherited from ​

ChartPropsBase.leaderLineSize

legendColor? ​

optional legendColor?: string

Inherited from ​

ChartPropsLegend.legendColor

legendFontFace? ​

optional legendFontFace?: string

Inherited from ​

ChartPropsLegend.legendFontFace

legendFontSize? ​

optional legendFontSize?: number

Inherited from ​

ChartPropsLegend.legendFontSize

legendLayout? ​

optional legendLayout?: PositionProps

Manual legend placement within the chart area.

Each of x/y/w/h is a fraction (0-1) of the chart's width/height. x/y position the legend's top-left corner relative to the chart edge; w/h set its size. Each axis is independent: provide only x to move the legend horizontally while leaving vertical placement and size automatic. Setting this overrides the automatic placement implied by legendPos.

Held to the plot area's ChartPropsBase.layout rule: x and y from 0 to 1, w and h above 0 and at most 1. A value outside that, or one that is not a number, warns and is dropped, so that axis stays automatic. ST_Double itself is unbounded; whether PowerPoint places a legend reaching past the chart edge has not been checked, so the narrower rule stands.

Has no effect unless showLegend is true.

Example ​

ts
{ x: 0.7, y: 0.3, w: 0.25, h: 0.4 }

Inherited from ​

ChartPropsLegend.legendLayout

legendPos? ​

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

Where the legend sits (ST_LegendPos).

Default ​

ts
'r'

Inherited from ​

ChartPropsLegend.legendPos

lineCap? ​

optional lineCap?: LineCap

MS-PPT > Chart format > Format Data Series > Line > Cap type

  • line cap type

Default ​

ts
flat

Inherited from ​

ChartPropsChartLine.lineCap

lineDash? ​

optional lineDash?: ChartLineDash

MS-PPT > Chart format > Format Data Series > Line > Dash type (chart-level default)

  • applies to every series that has no entry in lineDashValues

Default ​

ts
solid

Inherited from ​

ChartPropsChartLine.lineDash

lineDashValues? ​

optional lineDashValues?: ChartLineDash[]

Per-series dash type overrides; index matches the series order in the data array — and on a combo, the order across every subchart, the same index seriesOptions uses.

  • entries shorter than the series count fall back to lineDash
  • example: ['solid', 'dash', 'lgDash'] gives each series its own dash pattern

Inherited from ​

ChartPropsChartLine.lineDashValues

lineDataSymbol? ​

optional lineDataSymbol?: "none" | "square" | "triangle" | "circle" | "diamond" | "dash" | "dot"

MS-PPT > Chart format > Format Data Series > Marker Options > Built-in > Type

  • marker type

Default ​

ts
circle

Inherited from ​

ChartPropsChartLine.lineDataSymbol

lineDataSymbolLineColor? ​

optional lineDataSymbolLineColor?: string

MS-PPT > Chart format > Format Data Series > [Marker Options] > Border > Color

  • border color

Default ​

ts
circle

Inherited from ​

ChartPropsChartLine.lineDataSymbolLineColor

lineDataSymbolLineSize? ​

optional lineDataSymbolLineSize?: number

MS-PPT > Chart format > Format Data Series > [Marker Options] > Border > Width

  • border width (points)

Default ​

ts
0.75

Inherited from ​

ChartPropsChartLine.lineDataSymbolLineSize

lineDataSymbolSize? ​

optional lineDataSymbolSize?: number

MS-PPT > Chart format > Format Data Series > Marker Options > Built-in > Size

  • marker size
  • range: 2-72

Default ​

ts
6

Inherited from ​

ChartPropsChartLine.lineDataSymbolSize

lineSize? ​

optional lineSize?: number

MS-PPT > Chart format > Format Data Series > Line > Width

  • line width (points)
  • range: 0-1584

Default ​

ts
2

Inherited from ​

ChartPropsChartLine.lineSize

lineSmooth? ​

optional lineSmooth?: boolean

MS-PPT > Chart format > Format Data Series > Line > Smoothed line

  • "Smoothed line"

Default ​

ts
false

Inherited from ​

ChartPropsChartLine.lineSmooth

metadata? ​

optional metadata?: Record<string, string>

Custom chart-level metadata, emitted as a schema-valid extension on the chart space (c:chartSpace/c:extLst) under a stable ts-pptx vendor GUID.

  • Use for round-trippable, machine-readable annotations a consumer wants to travel with the chart (e.g. a source-data id, a generator tag, a semantic role). PowerPoint preserves the extension untouched and ignores it for rendering.
  • Keys must be non-empty strings; values must be strings. Invalid entries are dropped with a console warning rather than emitting degenerate XML.

Example ​

ts
{ sourceId: 'q3-revenue', generator: 'my-deck-tool' }

objectLock? ​

optional objectLock?: ObjectLockProps

Object lock flags (DrawingML a:spLocks / a:picLocks / a:graphicFrameLocks)

  • restrict how the object can be manipulated in PowerPoint (e.g. prevent moving, resizing, or grouping)
  • each flag maps 1:1 to the OOXML attribute of the same name; only flags set to true are emitted
  • PowerPoint UI: Selection Pane / right-click protections (most locks are honored at edit time, not as a password)
  • flags only apply to the object types that support them (see each flag); flags set on an unsupported object type are ignored with a console warning

Examples ​

ts
{ noMove: true, noResize: true } // pin an object in place
ts
{ noGrp: true } // exclude from grouping

Inherited from ​

ObjectNameProps.objectLock

objectName? ​

optional objectName?: string

Object name

  • used instead of the default name for the object's kind: Text 1, Shape 2, Image 1 and so on, numbered per kind (see docs/reference/object-names.md)
  • PowerPoint: Home > Arrange > Selection Pane...

Example ​

ts
'Antenna Design 9'

Inherited from ​

ObjectNameProps.objectName

paraIndent? ​

optional paraIndent?: number | "inherit"

First-line indent (points) — a:pPr/@indent, the offset of the paragraph's FIRST line from paraMarginLeft. Negative hangs the first line to the left of the body, which is what a bulleted paragraph does; positive indents it to the right, the "first line indented" prose form. PowerPoint: Paragraph > Indentation > Special.

  • 'inherit' writes no @indent at all, so the paragraph takes whatever its list style (a:lstStyle → placeholder → layout → master) sets — the same third state bullet spells, on the attribute beside it
  • omitting the option keeps the bullet-derived default: a drawn bullet hangs the first line by its margin, bullet: false writes indent="0", bullet: 'inherit' writes nothing
  • a value here overrides all of those, in every bullet state

Examples ​

ts
-18 // hang the first line 18pt left of the body text
ts
18 // indent the first line 18pt, prose style
ts
'inherit' // keep the list style's indent, even on a bulleted paragraph

Remarks ​

Read from the opening run of a paragraph, like bullet and unlike align; a value on a continuation run is ignored.

Inherited from ​

ChartPropsTitle.paraIndent

paraMarginLeft? ​

optional paraMarginLeft?: number | "inherit"

Left margin of the paragraph (points) — a:pPr/@marL, where the paragraph's body text starts. This is the paragraph's own margin, not the text frame's internal padding (margin) and not the discrete outline level (indentLevel, which writes a:p/@lvl). PowerPoint: Paragraph > Indentation > Before text.

  • 'inherit' writes no @marL at all, so the paragraph takes whatever its list style (a:lstStyle → placeholder → layout → master) sets — the third state that omission cannot spell, since omitting it writes the bullet-derived default
  • omitting the option keeps that default: a drawn bullet writes its own margin (see bullet.indent), bullet: false writes marL="0", bullet: 'inherit' writes nothing
  • a value here overrides all of those, in every bullet state

Examples ​

ts
36 // body text starts 36pt (0.5in) from the frame's text edge
ts
'inherit' // keep the list style's margin, even on a bulleted paragraph

Remarks ​

Read from the opening run of a paragraph, like bullet and unlike align; a value on a continuation run is ignored.

Inherited from ​

ChartPropsTitle.paraMarginLeft

plotArea? ​

optional plotArea?: ChartPropsFillLine

PowerPoint: Format Plot Area (Fill & Border/Line)

Inherited from ​

ChartPropsBase.plotArea

radarStyle? ​

optional radarStyle?: "standard" | "marker" | "radar" | "filled" | "markers"

Radar chart sub-type. Two vocabularies are accepted and mean the same three things: this library's PowerPoint-UI names (radar, markers, filled) and ST_RadarStyle's own wire spellings (standard, marker, filled), which is what the chart part shows. filled is spelled the same in both.

Default ​

ts
radar

Inherited from ​

ChartPropsChartRadar.radarStyle

secondaryCatAxis? ​

optional secondaryCatAxis?: boolean

Whether data should use secondary category axis (instead of primary)

A combo subchart plots on the secondary category and value axes together, because a plot's two axes have to cross each other. When no subchart sets secondaryValAxis, the secondary value axis is written hidden; valAxes[1] can show it.

Default ​

ts
false

Inherited from ​

ChartPropsAxisCat.secondaryCatAxis

secondaryValAxis? ​

optional secondaryValAxis?: boolean

Whether data should use secondary value axis (instead of primary)

A combo subchart plots on the secondary category and value axes together, because a plot's two axes have to cross each other. When no subchart sets secondaryCatAxis, the secondary category axis is written hidden, as PowerPoint does for a series moved to its secondary axis; catAxes[1] can show it.

Default ​

ts
false

Inherited from ​

ChartPropsAxisVal.secondaryValAxis

serAxisHidden? ​

optional serAxisHidden?: boolean

Inherited from ​

ChartPropsAxisSer.serAxisHidden

serAxisLabelColor? ​

optional serAxisLabelColor?: string

Inherited from ​

ChartPropsAxisSer.serAxisLabelColor

serAxisLabelFontBold? ​

optional serAxisLabelFontBold?: boolean

Inherited from ​

ChartPropsAxisSer.serAxisLabelFontBold

serAxisLabelFontFace? ​

optional serAxisLabelFontFace?: string

Inherited from ​

ChartPropsAxisSer.serAxisLabelFontFace

serAxisLabelFontItalic? ​

optional serAxisLabelFontItalic?: boolean

Inherited from ​

ChartPropsAxisSer.serAxisLabelFontItalic

serAxisLabelFontSize? ​

optional serAxisLabelFontSize?: number

Inherited from ​

ChartPropsAxisSer.serAxisLabelFontSize

serAxisLabelFrequency? ​

optional serAxisLabelFrequency?: string | number

Show every Nth series-axis label (c:tickLblSkip, ST_Skip) on a 3-D chart.

  • a whole number of at least 1; anything else warns and leaves the element off

Pass a number; see ChartPropsAxisCat.catAxisLabelFrequency for the string half.

Inherited from ​

ChartPropsAxisSer.serAxisLabelFrequency

serAxisLabelPos? ​

optional serAxisLabelPos?: "none" | "high" | "low" | "nextTo"

Inherited from ​

ChartPropsAxisSer.serAxisLabelPos

serAxisLine? ​

optional serAxisLine?: StrokeProps

The series axis line, as a stroke — the same StrokeProps the other two axes and every gridline take. See ChartPropsAxisCat.catAxisLine.

The series axis is the third axis of a 3-D chart, and it was the one axis whose line could be shown and coloured but not sized or dashed: the emitter hardcoded one point and solid where the other two read the caller. Comparing the three axes' option spellings side by side is how that was found.

Inherited from ​

ChartPropsAxisSer.serAxisLine

serAxisLineColor? ​

optional serAxisLineColor?: string

Series-axis line colour.

Deprecated ​

Use serAxisLine.color.

Inherited from ​

ChartPropsAxisSer.serAxisLineColor

serAxisLineShow? ​

optional serAxisLineShow?: boolean

Draw the series-axis line at all.

Deprecated ​

Use serAxisLine.type: 'none' to suppress it.

Default ​

ts
true

Inherited from ​

ChartPropsAxisSer.serAxisLineShow

serAxisLineSize? ​

optional serAxisLineSize?: number

Series-axis line width in points.

Deprecated ​

Use serAxisLine.width.

Inherited from ​

ChartPropsAxisSer.serAxisLineSize

serAxisLineStyle? ​

optional serAxisLineStyle?: "dash" | "solid" | "dot"

Series-axis line dash.

Deprecated ​

Use serAxisLine.dashType, which takes the full ST_PresetLineDashVal set.

Inherited from ​

ChartPropsAxisSer.serAxisLineStyle

serAxisOrientation? ​

optional serAxisOrientation?: "maxMin" | "minMax"

Inherited from ​

ChartPropsAxisSer.serAxisOrientation

serAxisTitle? ​

optional serAxisTitle?: string

Inherited from ​

ChartPropsAxisSer.serAxisTitle

serAxisTitleColor? ​

optional serAxisTitleColor?: string

Inherited from ​

ChartPropsAxisSer.serAxisTitleColor

serAxisTitleFontFace? ​

optional serAxisTitleFontFace?: string

Inherited from ​

ChartPropsAxisSer.serAxisTitleFontFace

serAxisTitleFontSize? ​

optional serAxisTitleFontSize?: number

Inherited from ​

ChartPropsAxisSer.serAxisTitleFontSize

serAxisTitleRotate? ​

optional serAxisTitleRotate?: number

Inherited from ​

ChartPropsAxisSer.serAxisTitleRotate

serGridLine? ​

optional serGridLine?: OptsChartGridLine

Inherited from ​

ChartPropsAxisSer.serGridLine

seriesOptions? ​

optional seriesOptions?: ChartSeriesOpts[]

Per-series style overrides.

Element at index N applies to the Nth series of the chart — the same number the series carries in <c:idx>/<c:order>. For most plots that is its position in data; on a combo it counts across every subchart in order, so a bar(2) + line(1) combo reaches the line at index 2. A scatter or bubble series counts one lower than its position, because the X row in front of it is not a series: seriesOptions[0] styles data[1]. Missing indices or unset fields fall back to the chart-level option.

Not every field reaches every plot, and a stated field that cannot be resolved warns (chart/option-not-supported) naming itself rather than being dropped in silence:

  • color reaches every plot that colours series: bar, bar3d, area, line, radar, scatter, bubble, bubble3d, and (as the volume bar and the close marker) stock.
  • lineSize reaches only a series that strokes itself: line, radar, scatter, bubble and bubble3d. A bar or an area takes its outline from dataBorder; a stock price series draws no line at all.
  • the dataLabel* fields need a per-series <c:dLbls>, which the category-axis family and scatter emit. A bubble chart's label block is chart-level, and dataLabelFormatCode in particular has no referent on scatter, whose label builders emit no number format.
  • pie, doughnut and surface read nothing: a pie colours points and a surface colours bands, so a per-series override has no referent even in principle.

Inherited from ​

ChartPropsBase.seriesOptions

serLabelFormatCode? ​

optional serLabelFormatCode?: string

Inherited from ​

ChartPropsAxisSer.serLabelFormatCode

shadow? ​

optional shadow?: ShadowProps

Inherited from ​

ChartPropsBase.shadow

showBubbleSize? ​

optional showBubbleSize?: boolean

Show each bubble's size value as a data label (bubble / bubble3D charts only). Has no effect on other chart types.

Default ​

ts
false

Inherited from ​

ChartPropsBase.showBubbleSize

showCatAxisTitle? ​

optional showCatAxisTitle?: boolean

Inherited from ​

ChartPropsAxisCat.showCatAxisTitle

showDataTable? ​

optional showDataTable?: boolean

Whether to show a data table adjacent to the chart

Default ​

ts
false

Inherited from ​

ChartPropsDataTable.showDataTable

showDataTableHorzBorder? ​

optional showDataTableHorzBorder?: boolean

Inherited from ​

ChartPropsDataTable.showDataTableHorzBorder

showDataTableKeys? ​

optional showDataTableKeys?: boolean

Inherited from ​

ChartPropsDataTable.showDataTableKeys

showDataTableOutline? ​

optional showDataTableOutline?: boolean

Inherited from ​

ChartPropsDataTable.showDataTableOutline

showDataTableVertBorder? ​

optional showDataTableVertBorder?: boolean

Inherited from ​

ChartPropsDataTable.showDataTableVertBorder

showLabel? ​

optional showLabel?: boolean

Enable data labels, with a meaning that is overloaded per plot type — it is not a plain duplicate of ChartPropsBase.showValue:

  • pie / doughnut: shows the category name (c:showCatName);
  • scatter: turns on the labels ChartPropsDataLabel.dataLabelFormatScatter describes, and shows nothing without it: 'XY' shows both the value and the category name, and 'custom'/'customXY' show each point's label text;
  • chartEx (waterfall/funnel/…): OR-combined with showValue to show the value label.

For the common "show the numeric value" case on standard plots, prefer showValue.

Default ​

ts
false

Inherited from ​

ChartPropsBase.showLabel

showLeaderLines? ​

optional showLeaderLines?: boolean

Inherited from ​

ChartPropsBase.showLeaderLines

showLegend? ​

optional showLegend?: boolean

Default ​

ts
false

Inherited from ​

ChartPropsBase.showLegend

showPercent? ​

optional showPercent?: boolean

Default ​

ts
false

Inherited from ​

ChartPropsBase.showPercent

showSerAxisTitle? ​

optional showSerAxisTitle?: boolean

Inherited from ​

ChartPropsAxisSer.showSerAxisTitle

showSerName? ​

optional showSerName?: boolean

Default ​

ts
false

Inherited from ​

ChartPropsBase.showSerName

showTitle? ​

optional showTitle?: boolean

Default ​

ts
false

Inherited from ​

ChartPropsBase.showTitle

showValAxisTitle? ​

optional showValAxisTitle?: boolean

Inherited from ​

ChartPropsAxisVal.showValAxisTitle

showValue? ​

optional showValue?: boolean

Default ​

ts
false

Inherited from ​

ChartPropsBase.showValue

softBreakBefore? ​

optional softBreakBefore?: boolean

Add a soft line-break (shift+enter) before line text content

Default ​

ts
false

Inherited from ​

ChartPropsTitle.softBreakBefore

statistics? ​

optional statistics?: ChartExStatistics

Statistics configuration for a boxWhisker chart. Omit for PowerPoint's defaults (exclusive quartiles, mean marker shown, outliers shown).

Example ​

ts
{ quartileMethod: 'inclusive', meanLine: true }

Inherited from ​

ChartPropsChartBoxWhisker.statistics

stockStyle? ​

optional stockStyle?: "hlc" | "ohlc" | "vhlc" | "vohlc"

Stock (high-low-close) chart style — selects how many value series the chart expects and how they are drawn. The data series must be supplied in the exact order implied by the style:

  • 'hlc' — High, Low, Close (3 series). The close is marked with a dot.
  • 'ohlc' — Open, High, Low, Close (4 series). Open→close is drawn as up/down bars.
  • 'vhlc' — Volume, High, Low, Close (4 series). Volume is a column on its own axis.
  • 'vohlc' — Volume, Open, High, Low, Close (5 series). Volume column + up/down bars.

<c:hiLowLines> connect the high/low of each category in every style.

Default ​

ts
'hlc'

Inherited from ​

ChartPropsChartStock.stockStyle

subtotals? ​

optional subtotals?: number[]

Zero-based category indices to render as subtotal/total columns in a waterfall chart (columns anchored to the axis baseline rather than floating from the running cumulative value). Out-of-range or non-integer entries are dropped with a console warning.

Example ​

ts
[0, 4] // first and fifth categories are totals

Inherited from ​

ChartPropsChartWaterfall.subtotals

surface3D? ​

optional surface3D?: boolean

Draw a 3-D surface (<c:surface3DChart>) rather than a 2-D contour / top view (<c:surfaceChart>). The 3-D surface tilts the scene; the contour looks straight down.

Default ​

ts
true

Inherited from ​

ChartPropsChartSurface.surface3D

surfaceWireframe? ​

optional surfaceWireframe?: boolean

Draw the surface as a wireframe mesh (<c:wireframe val="1"/>) instead of a filled sheet. Applies to both the 3-D surface and the 2-D contour.

Default ​

ts
false

Inherited from ​

ChartPropsChartSurface.surfaceWireframe

tabStops? ​

optional tabStops?: object[]

tab stops

  • PowerPoint: Paragraph > Tabs > Tab stop position

alignment? ​

optional alignment?: "r" | "ctr" | "l" | "dec"

position ​

position: number

Example ​

ts
[{ position:1 }, { position:3 }] // Set first tab stop to 1 inch, set second tab stop to 3 inches

Inherited from ​

ChartPropsTitle.tabStops

textDirection? ​

optional textDirection?: "horz" | "vert" | "vert270" | "wordArtVert"

text direction horz = horizontal vert = rotate 90^ vert270 = rotate 270^ wordArtVert = stacked

Default ​

ts
'horz'

Inherited from ​

ChartPropsTitle.textDirection

textWarp? ​

optional textWarp?: "textNoShape" | "textPlain" | "textStop" | "textTriangle" | "textTriangleInverted" | "textChevron" | "textChevronInverted" | "textRingInside" | "textRingOutside" | "textArchUp" | "textArchDown" | "textCircle" | "textButton" | "textArchUpPour" | "textArchDownPour" | "textCirclePour" | "textButtonPour" | "textCurveUp" | "textCurveDown" | "textCanUp" | "textCanDown" | "textWave1" | "textWave2" | "textDoubleWave1" | "textWave4" | "textInflate" | "textDeflate" | "textInflateBottom" | "textDeflateBottom" | "textInflateTop" | "textDeflateTop" | "textDeflateInflate" | "textDeflateInflateDeflate" | "textFadeRight" | "textFadeLeft" | "textFadeUp" | "textFadeDown" | "textSlantUp" | "textSlantDown" | "textCascadeUp" | "textCascadeDown"

Preset text warp / WordArt shape (<a:bodyPr><a:prstTxWarp prst="..">), which bends the text along a preset path (arch, circle, wave, …) — the whole ST_TextShapeType set.

Examples ​

ts
'textArchUp' // bend text along an upward arch (e.g. a label following a ring/arc)
ts
'textCircle'

Inherited from ​

ChartPropsTitle.textWarp

title? ​

optional title?: string

Inherited from ​

ChartPropsTitle.title

titleAlign? ​

optional titleAlign?: string

Inherited from ​

ChartPropsTitle.titleAlign

titleBold? ​

optional titleBold?: boolean

Inherited from ​

ChartPropsTitle.titleBold

titleColor? ​

optional titleColor?: string

Inherited from ​

ChartPropsTitle.titleColor

titleFontFace? ​

optional titleFontFace?: string

Inherited from ​

ChartPropsTitle.titleFontFace

titleFontSize? ​

optional titleFontSize?: number

Inherited from ​

ChartPropsTitle.titleFontSize

titleItalic? ​

optional titleItalic?: boolean

Inherited from ​

ChartPropsTitle.titleItalic

titlePos? ​

optional titlePos?: object

Manual title position (inches), relative to the chart. Each axis is independent: omit x to keep automatic horizontal centering, or omit y to keep automatic vertical placement. Provide at least one.

x? ​

optional x?: number

y? ​

optional y?: number

Inherited from ​

ChartPropsTitle.titlePos

titleRotate? ​

optional titleRotate?: number

Inherited from ​

ChartPropsTitle.titleRotate

titleUnderline? ​

optional titleUnderline?: boolean

Inherited from ​

ChartPropsTitle.titleUnderline

transparency? ​

optional transparency?: number

Transparency (percent)

  • MS-PPT > Format Shape > Text Options > Text Fill & Outline > Text Fill > Transparency
  • range: 0-100

Default ​

ts
0

Inherited from ​

ChartPropsTitle.transparency

type? ​

optional type?: "area" | "line" | "bar" | "bar3D" | "bubble" | "bubble3D" | "doughnut" | "pie" | "radar" | "scatter" | "stock" | "surface" | "waterfall" | "funnel" | "treemap" | "sunburst" | "histogram" | "pareto" | "boxWhisker" | "regionMap"

Chart type — required when using the canonical addChart(data, options) signature.

  • Omit only for multi-type (combo) charts, where each ChartMulti entry carries its own type.

underline? ​

optional underline?: object

underline properties

  • PowerPoint: Font > Color & Underline > Underline Style/Underline Color
  • style is the full ST_TextUnderlineType enumeration (ECMA-376 §20.1.10.81)
  • 'none' is the explicit off: it writes a:rPr/@u="none", which overrides an underline the run would otherwise inherit from its list style, placeholder, layout or master. Omitting the option instead states nothing and lets that inheritance stand — the two are different facts, not two spellings of one.

color? ​

optional color?: string

style? ​

optional style?: "none" | "words" | "sng" | "dbl" | "heavy" | "dotted" | "dottedHeavy" | "dash" | "dashHeavy" | "dashLong" | "dashLongHeavy" | "dotDash" | "dotDashHeavy" | "dotDotDash" | "dotDotDashHeavy" | "wavy" | "wavyHeavy" | "wavyDbl"

Default ​

ts
(unset) inherit

Inherited from ​

ChartPropsTitle.underline

v3DPerspective? ​

optional v3DPerspective?: number

3D Perspecitve

  • range: 0-120

Default ​

ts
30

Inherited from ​

ChartPropsBase.v3DPerspective

v3DRAngAx? ​

optional v3DRAngAx?: boolean

Right Angle Axes

  • Shows chart from first-person perspective
  • Overrides v3DPerspective when true
  • PowerPoint: Chart Options > 3-D Rotation

Default ​

ts
false

Inherited from ​

ChartPropsBase.v3DRAngAx

v3DRotX? ​

optional v3DRotX?: number

X Rotation

  • PowerPoint: Chart Options > 3-D Rotation
  • range: 0-359.9

Default ​

ts
30

Inherited from ​

ChartPropsBase.v3DRotX

v3DRotY? ​

optional v3DRotY?: number

Y Rotation

  • range: 0-359.9

Default ​

ts
30

Inherited from ​

ChartPropsBase.v3DRotY

valAxes? ​

optional valAxes?: ChartPropsAxisVal[]

Multi-Chart prop: array of val axes

Inherited from ​

ChartPropsAxisVal.valAxes

valAxisCrossBetween? ​

optional valAxisCrossBetween?: "between" | "midCat"

Controls where axis values are plotted relative to tick marks

  • 'between' = values plotted between tick marks (default for bar/column/line)
  • 'midCat' = values plotted on tick marks (default for scatter/area)
  • PowerPoint: Format Axis > Axis Options > Axis crosses > On tick marks / Between tick marks

Inherited from ​

ChartPropsAxisVal.valAxisCrossBetween

valAxisCrossesAt? ​

optional valAxisCrossesAt?: number | "autoZero"

Inherited from ​

ChartPropsAxisVal.valAxisCrossesAt

valAxisDisplayUnit? ​

optional valAxisDisplayUnit?: "hundreds" | "thousands" | "tenThousands" | "hundredThousands" | "millions" | "tenMillions" | "hundredMillions" | "billions" | "trillions"

Inherited from ​

ChartPropsAxisVal.valAxisDisplayUnit

valAxisDisplayUnitLabel? ​

optional valAxisDisplayUnitLabel?: boolean

Inherited from ​

ChartPropsAxisVal.valAxisDisplayUnitLabel

valAxisHidden? ​

optional valAxisHidden?: boolean

Inherited from ​

ChartPropsAxisVal.valAxisHidden

valAxisLabelColor? ​

optional valAxisLabelColor?: string

Inherited from ​

ChartPropsAxisVal.valAxisLabelColor

valAxisLabelFontBold? ​

optional valAxisLabelFontBold?: boolean

Inherited from ​

ChartPropsAxisVal.valAxisLabelFontBold

valAxisLabelFontFace? ​

optional valAxisLabelFontFace?: string

Inherited from ​

ChartPropsAxisVal.valAxisLabelFontFace

valAxisLabelFontItalic? ​

optional valAxisLabelFontItalic?: boolean

Inherited from ​

ChartPropsAxisVal.valAxisLabelFontItalic

valAxisLabelFontSize? ​

optional valAxisLabelFontSize?: number

Inherited from ​

ChartPropsAxisVal.valAxisLabelFontSize

valAxisLabelFormatCode? ​

optional valAxisLabelFormatCode?: string

Inherited from ​

ChartPropsAxisVal.valAxisLabelFormatCode

valAxisLabelPos? ​

optional valAxisLabelPos?: "none" | "high" | "low" | "nextTo"

Inherited from ​

ChartPropsAxisVal.valAxisLabelPos

valAxisLabelRotate? ​

optional valAxisLabelRotate?: number

Inherited from ​

ChartPropsAxisVal.valAxisLabelRotate

valAxisLine? ​

optional valAxisLine?: StrokeProps

The value axis line, as a stroke — the same StrokeProps the other two axes and every gridline take. See ChartPropsAxisCat.catAxisLine.

Inherited from ​

ChartPropsAxisVal.valAxisLine

valAxisLineColor? ​

optional valAxisLineColor?: string

Value-axis line colour.

Deprecated ​

Use valAxisLine.color.

Inherited from ​

ChartPropsAxisVal.valAxisLineColor

valAxisLineShow? ​

optional valAxisLineShow?: boolean

Draw the value-axis line at all.

Deprecated ​

Use valAxisLine.type: 'none' to suppress it.

Default ​

ts
true

Inherited from ​

ChartPropsAxisVal.valAxisLineShow

valAxisLineSize? ​

optional valAxisLineSize?: number

Value-axis line width in points.

Deprecated ​

Use valAxisLine.width.

Inherited from ​

ChartPropsAxisVal.valAxisLineSize

valAxisLineStyle? ​

optional valAxisLineStyle?: "dash" | "solid" | "dot"

Value-axis line dash.

Deprecated ​

Use valAxisLine.dashType, which takes the full ST_PresetLineDashVal set.

Inherited from ​

ChartPropsAxisVal.valAxisLineStyle

valAxisLogScaleBase? ​

optional valAxisLogScaleBase?: number

PowerPoint: Format Axis > Axis Options > Logarithmic scale - Base

  • range: 2-1000 (ST_LogBase); a value outside it clamps with a warning, and NaN throws

Inherited from ​

ChartPropsAxisVal.valAxisLogScaleBase

valAxisMajorTickMark? ​

optional valAxisMajorTickMark?: "none" | "cross" | "in" | "out"

Inherited from ​

ChartPropsAxisVal.valAxisMajorTickMark

valAxisMajorUnit? ​

optional valAxisMajorUnit?: number

Spacing between major tick marks on the value axis (c:majorUnit, ST_AxisUnit).

  • above 0; anything else warns and leaves the element off
  • PowerPoint: Format Axis > Axis Options > Units > Major

Inherited from ​

ChartPropsAxisVal.valAxisMajorUnit

valAxisMaxVal? ​

optional valAxisMaxVal?: number

Axis maximum (c:max). A value that is not a finite number throws.

Inherited from ​

ChartPropsAxisVal.valAxisMaxVal

valAxisMinorTickMark? ​

optional valAxisMinorTickMark?: "none" | "cross" | "in" | "out"

Inherited from ​

ChartPropsAxisVal.valAxisMinorTickMark

valAxisMinorUnit? ​

optional valAxisMinorUnit?: number

Spacing between minor tick marks on the value axis (c:minorUnit) — the sibling valAxisMajorUnit had had for years, while the category and series axes carried both.

  • PowerPoint: Format Axis > Axis Options > Units > Minor

Inherited from ​

ChartPropsAxisVal.valAxisMinorUnit

valAxisMinVal? ​

optional valAxisMinVal?: number

Axis minimum (c:min). A value that is not a finite number throws.

Inherited from ​

ChartPropsAxisVal.valAxisMinVal

valAxisOrientation? ​

optional valAxisOrientation?: "maxMin" | "minMax"

Inherited from ​

ChartPropsAxisVal.valAxisOrientation

valAxisTitle? ​

optional valAxisTitle?: string

Inherited from ​

ChartPropsAxisVal.valAxisTitle

valAxisTitleColor? ​

optional valAxisTitleColor?: string

Inherited from ​

ChartPropsAxisVal.valAxisTitleColor

valAxisTitleFontFace? ​

optional valAxisTitleFontFace?: string

Inherited from ​

ChartPropsAxisVal.valAxisTitleFontFace

valAxisTitleFontSize? ​

optional valAxisTitleFontSize?: number

Inherited from ​

ChartPropsAxisVal.valAxisTitleFontSize

valAxisTitleRotate? ​

optional valAxisTitleRotate?: number

Inherited from ​

ChartPropsAxisVal.valAxisTitleRotate

valGridLine? ​

optional valGridLine?: OptsChartGridLine

Inherited from ​

ChartPropsAxisVal.valGridLine

valign? ​

optional valign?: VAlign

vertical alignment

Default ​

ts
'top'

Inherited from ​

ChartPropsTitle.valign

valLabelFormatCode? ​

optional valLabelFormatCode?: string

Value label format code

  • this also directs Data Table formatting

Examples ​

ts
'#%' // round percent
ts
'0.00%' // shows values as '0.00%'
ts
'$0.00' // shows values as '$0.00'

Inherited from ​

ChartPropsAxisVal.valLabelFormatCode

w? ​

optional w?: Coord

Width

  • inches or percentage

Examples ​

ts
10.25 // width in inches
ts
'75%' // width as percentage of slide size

Inherited from ​

PositionProps.w

x? ​

optional x?: Coord

Horizontal position

  • inches or percentage

Examples ​

ts
10.25 // position in inches
ts
'75%' // position as percentage of slide size

Inherited from ​

PositionProps.x

y? ​

optional y?: Coord

Vertical position

  • inches or percentage

Examples ​

ts
10.25 // position in inches
ts
'75%' // position as percentage of slide size

Inherited from ​

PositionProps.y